5分钟认识Neon MCP Server：用自然语言管理Postgres数据库的MCP神器

mcp-server-neon（Neon MCP Server）是一个开源的 MCP Server，它让 AI 助手能够通过自然语言直接管理 Neon 平台上的 Postgres 数据库：建项目、建分支、跑查询、做数据库迁移，全程不用手写 SQL，也不用直接调用 API。对于想体验 AI + 数据库玩法的新手来说，它是目前上手成本最低的 Postgres MCP 工具之一。

一、Neon MCP Server 是什么？

Model Context Protocol（MCP） 是 LLM 与外部系统之间交换上下文的标准协议，而 Neon MCP Server 就是把"自然语言请求"翻译成 Neon API 调用的桥梁：

简单理解就是三层角色：

它作为远程服务运行在 Vercel 上（mcp.neon.tech），基于 Next.js App Router 构建，核心入口是 app/api/[transport]/route.ts（Streamable HTTP 传输端点），所有数据库操作都经过它中转。

二、它能为新手做什么？

不用记 SQL 语法，直接用对话完成数据库任务：

• 💬 “帮我创建一个叫 my-database 的 Postgres 数据库，再建一张 users 表，包含 id、name、email、password 列”
• 🚀 “给 my-project 项目跑一次迁移，给 users 表加上 created_at 列”
• 📊 “总结一下我所有的 Neon 项目，以及每个项目里有哪些数据”

更贴心的是它的迁移机制：AI 会先在临时分支上执行迁移并验证，确认没问题后才合并回主分支，把"改坏生产库"的风险降到了最低。

三、5分钟上手：3种连接方式

方式一：一条命令自动配置（推荐新手）

前提：安装好一个 MCP 客户端（如 Cursor、VS Code、Claude Code）、注册一个 Neon 账号、Node.js ≥ 18。

npx neon@latest init

这条命令会自动完成 OAuth 认证、创建 API Key 并写好编辑器配置，适合 Cursor、VS Code（GitHub Copilot）和 Claude Code。

方式二：连接官方远程 MCP Server（OAuth 认证）

npx add-mcp "https://mcp.neon.tech/mcp?category=projects&category=branches&category=endpoints&category=querying&category=schema"

或者在客户端的 MCP 配置文件中加入：

{ "mcpServers": { "Neon": { "type": "http", "url": "https://mcp.neon.tech/mcp" } } }

添加后重启/刷新 MCP 客户端，浏览器会弹出一个 OAuth 授权窗口，跟着提示点完即可，全程无需管理 API Key。

方式三：API Key 认证

适合 OAuth 不可用的场景（如远程 Agent）。在 Neon Console 创建一个 API Key，然后在连接 URL 后追加--header "Authorization: Bearer <你的Key>"即可。

💡 三种方式都会自动获得官方后续更新的功能，无需手动升级。

四、OAuth 授权：权限完全由你决定

连接成功后最重要的环节是授权页——你可以精确控制 AI 客户端能"看到什么、改什么"。

第 1 步：选择项目范围

页面中可以选择"所有可访问的项目"，或者只授权"某一个项目"。

第 2 步：勾选工具类别

按需勾选 Projects、Branches、Schema、Querying、Endpoints 等类别，没勾的类别对应的工具 AI 根本看不到：

第 3 步：确认权限

如果 URL 里带了固定参数，授权页会展示一份只读确认单，明确列出项目、工具类别和权限，想改范围就得重新授权：

这套精细的授权过滤逻辑实现在 mcp/tools/grant-filter.ts 和 mcp/utils/grant-context.ts 中。

五、安全配置：只读模式与 URL 参数

最实用的安全开关是只读模式：在 URL 上加?readonly=true，AI 就只能查、不能改——列表项目、查看表结构、执行查询可用，而创建项目、建分支、跑迁移等写操作全部被禁用。

组合示例（只读 + 限定项目 + 固定角色）：

{ "mcpServers": { "Neon": { "url": "https://mcp.neon.tech/mcp?readonly=true&projectId=my-project-id&roleName=app_reader" } } }

只读模式还会把run_sql的每条查询包进READ ONLY事务里执行，双重保险。相关实现见 mcp/utils/read-only.ts。

六、核心功能一览

Neon MCP Server 内置了几十种工具（定义集中在 mcp/tools/definitions.ts），常用类别包括：

• 项目管理：list_projects、create_project、describe_project
• 分支管理：create_branch、reset_from_parent、restore_snapshot
• SQL 执行：run_sql、run_sql_transaction、get_database_tables
• 数据库迁移：prepare_database_migration+complete_database_migration（两阶段安全迁移）
• 性能调优：inspect_database、list_slow_queries、explain_sql_statement
• 文档搜索：search_docs、get_doc，AI 可以直接查 Neon 官方文档

七、给新手的安全提醒 ⚠️

1. 始终审核 AI 请求执行的操作再放行，尤其是删除、迁移类操作
2. 官方建议仅用于本地开发和 IDE 集成，不建议用于生产环境
3. 给 AI 的权限"够用就好"：优先单项目 + 只读模式
4. 项目采用 MIT 协议，可自由部署和二次开发

5分钟配好连接，接下来就可以用自然语言让 AI 帮你管库了——从"建个表"到"跑次迁移"，试试看吧 🚀