Neon MCP Server 是什么？
Neon MCP Server 是 Neon 官方的 Postgres 项目连接器。它让 Codex 查看指定项目的分支、数据库和表结构，也可以通过 projectId 与 readonly 参数把首次访问限制为只读。
一句话理解连接 Neon 项目与 Postgres 数据库，可按只读、项目和工具类别缩小远程能力。
为什么需要它？
把 Neon 管理与数据库上下文接入开发任务，并通过 `readonly` 与 `projectId` 控制范围。
接入前，AI 只能依赖你粘贴的材料、截图或旧上下文；接入后，它可以在你授权的范围内调用真实工具，并把结果、来源和状态带回当前任务。
核心能力
查询 Neon 项目和分支
把真实信息带回当前任务，减少反复复制和手动核对。
运行受控数据库查询
在明确授权范围内调用工具，并保留执行过程和结果。
在授权时管理模式与迁移
回读来源、状态与限制，方便继续处理和人工验收。
适合谁？怎么用？
- 查看 Neon 项目、分支和 Postgres 结构
- 使用 Neon Postgres，需要查询模式、分支或测试数据库状态的开发团队。
- projectId、分支、表和返回行数与 Neon 控制台一致，保持 readonly=true。
- 不适合直接操作生产迁移、删除分支或修改数据库。
- 非只读模式可以改变数据库和项目
- 查询结果可能含个人或业务数据
怎么接入？
- 1准备
在 Neon 创建测试项目，或确认现有项目 ID。
- 2授权
将
https://mcp.neon.tech/mcp?readonly=true&projectId=<项目ID>登记为 HTTP MCP。 - 3连接
完成 OAuth 或按官方说明使用受限 API Key。
- 4开始使用
列出工具并读取数据库结构，确认项目范围。
安装命令
添加 Neon MCP Server
codex mcp add neon --url "https://mcp.neon.tech/mcp?readonly=true&projectId=YOUR_PROJECT_ID"把 YOUR_PROJECT_ID 换成测试项目 ID，并保留 readonly=true 完成首次验证。
检查命令
确认 MCP 已经登记
codex mcp list不想自己操作终端时，把下面整段发给 Codex。它会先核对官方说明和前置条件，遇到凭证或占位符会停下来询问。
发给 Codex
自助接入 Neon MCP Server
请帮我在当前电脑上接入并验证 Neon MCP Server。
官方来源：https://github.com/neondatabase/mcp-server-neon
目标接入命令：codex mcp add neon --url "https://mcp.neon.tech/mcp?readonly=true&projectId=YOUR_PROJECT_ID"
请按以下步骤执行：
1. 先阅读官方 README，核对当前推荐接入方式与上述命令。如果官方说明已经变化，先告诉我差异，不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证，也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符，先列出需要我提供的值并停下来，不要自行猜测。
4. 条件满足后执行接入命令，再运行 codex mcp list，确认 Neon MCP Server 已登记，并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接：请用 Neon MCP 读取测试项目的分支和表结构，并运行一个限制 10 行的只读查询。
6. 不要创建、修改、删除、发送内容，也不要连接生产环境；需要写权限或更高权限时先征求我确认。- 复制完整指令，发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境；遇到 Token、项目 ID、路径或其他占位符时，应停下来向你确认。
- 接入后运行
codex mcp list，再用 Neon MCP Server 的只读首测任务回读结果。
第一次调用示例
登记完成后，新开一个任务，先用下面这句做只读验证，把目标、范围和停止条件一次说清楚。
发给 Codex
第一次只读任务
请用 Neon MCP 读取测试项目的分支和表结构，并运行一个限制 10 行的只读查询。怎样算成功
projectId、分支、表和返回行数与 Neon 控制台一致，保持 readonly=true。
- 先检查项目、分支和模式。
- 运行带限制的只读查询。
- 与 Neon 控制台和 SQL 客户端核对结果。
- 移除
readonly或执行迁移前必须单独评审。
权限与安全
凭证与连接方式
远程 HTTP；URL 限定 projectId 和 readonly=true，使用测试项目。
- 非只读模式可以改变数据库和项目
- 查询结果可能含个人或业务数据
- 生产项目必须固定 projectId、最小角色、只读参数和审计
