← 返回目录

Neon MCP Server

官方

通过自然语言管理 Neon 上的 Lakebase Postgres 数据库。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 数据库第 6 / 58
Stars: ★ 650 非常热门
传输方式: Streamable HTTP · SSE
运行环境: 远程托管（无需本地环境）
凭据: 可选 API Key
许可证: MIT
最近提交: 7 天前
工具数: 34

73FMRS · B

Neon 官方 MCP 服务器，支持远程托管和本地开发，功能丰富，涵盖项目管理、分支、SQL 查询、迁移、优化、认证和数据 API。适合用自然语言管理 Neon 数据库，但需注意安全问题。

最强项 · 维护活跃度 18/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

16/20

维护活跃度

18/20

文档质量

17/20

安装易用性

14/20

查看各项评分依据

可靠性 8/20: 证据显示：仓库有完善的测试金字塔（单元、集成、端到端测试）和CI配置，README中明确列出了测试命令，且包含MCP协议端到端测试。代码结构清晰（Next.js应用，mcp/目录包含工具和处理器），提供了读取模式、HTTP头等配置。但静态审查未执行测试，无法验证实际行为，且错误处理和边缘情况未被充分覆盖，因此可靠性得分低于满分。扣分原因：未实际运行测试，且错误处理和依赖控制的具体实现缺乏静态证据。
安全与权限 16/20: 证据显示：README明确警告安全风险，建议生产环境不要使用，提供OAuth和API密钥认证，支持读取模式、项目范围限制（projectId）和工具类别过滤，符合最小权限原则。OAuth流程有专门端点（authorize, token, revoke），密钥通过环境变量管理，连接字符串工具可能暴露敏感信息但受权限控制。扣分原因：删除项目等危险操作没有显式的确认机制（仅依赖用户提示），读取模式下的SQL工具可能仍允许读取操作，且未明确说明数据流披露。
维护活跃度 18/20: 证据显示：仓库活跃，有621颗星和32个未关闭问题，未被归档，许可证为MIT，有明确的开发流程（pnpm、corepack）和CI测试命令。README显示了频繁的更新和功能添加（如查询日志、文档资源工具）。扣分原因：未看到明确的版本发布策略或安全响应渠道，依赖更新策略未详细说明。
文档质量 17/20: 证据显示：README非常详细，包括多种安装方式（快速设置、OAuth、API密钥）、工具列表带详细描述、读取模式说明、URL查询参数、SSE传输（已弃用）的指示、开发指南和环境变量表。扣分原因：默认值如项目ID或组织ID的使用可能需要更多上下文，未提供故障排查或成本限制的详细说明，但主要是优点。
安装易用性 14/20: 证据显示：提供了多种设置方式，包括远程服务器URL和配置示例（JSON），支持OAuth和API密钥，支持主流客户端（Cursor、VS Code、Claude Code），并有快速设置命令（npx add-mcp）。README包含具体的客户配置示例。扣分原因：静态审查未验证安装过程，且依赖Node.js和Corepack，对于非Node环境可能复杂，缺少详细的逐步故障排查。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据连接数据库

适合谁

希望使用自然语言管理 Neon 数据库的开发者和非开发者。
在 IDE 或聊天界面中快速完成数据库任务的用户。
需要安全迁移和查询优化的团队。

不适合谁

需要精细控制底层的生产环境。
需要完整 SQL 界面和复杂事务处理的用户。
希望完全离线运行或不依赖远程服务的用户。

所需权限

需 Neon 账户和认证（OAuth 或 API 密钥）。
访问、创建、修改和删除 Neon 项目、分支、数据库及资源。
执行 SQL 查询（读写）。
管理认证和 Data API 配置。
读取日志和文档索引。

风险与副作用

自然语言请求可能误执行破坏性操作（如删除项目或分支）。
未经授权的人员可能通过 API 密钥或 OAuth 访问您的账户。
生产环境使用有意外变更风险，官方建议仅在本地开发使用。
需要谨慎审查 LLM 建议的操作。

安装接入

准备工作

运行环境：远程托管（无需本地环境）

安装 MCP 客户端（如 Claude Desktop、Cursor）。
使用 OAuth 或 API 密钥连接到远程服务器：

OAuth：运行 npx add-mcp https://mcp.neon.tech/mcp 或配置 {"mcpServers":{"Neon":{"type":"http","url":"https://mcp.neon.tech/mcp"}}}，然后按照浏览器 OAuth 流程授权。
API 密钥：创建 Neon API 密钥，并配置 {"mcpServers":{"Neon":{"type":"http","url":"https://mcp.neon.tech/mcp","headers":{"Authorization":"Bearer <API_KEY>"}}}}。

重启或刷新 MCP 客户端。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add --transport http Neon https://mcp.neon.tech/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端连接 https://mcp.neon.tech/mcp 完成 OAuth 授权后，刷新客户端，工具列表中应出现 list_projects 等工具；也可让客户端执行“列出我的 Neon 项目”来验证连接。

常见排障

连接失败：检查网络代理或防火墙，并确保客户端支持 streamable-http。
认证错误：重新授权 OAuth 或检查 API 密钥是否有效。
工具不可用：检查是否启用了只读模式或限制了工具类别。
项目访问：确认项目属于您的个人账户或提供了组织 ID。
IP 白名单：若启用 IP Allow，将 IP 地址 `34.192.103.46` 和 `23.22.233.166` 加入白名单。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我账户里的所有 Neon 项目，并总结每个项目里有什么数据。
在我的项目 my-project 里创建一个名为 my-database 的数据库，再创建一个包含 id、name、email、password 列的 users 表。
对 my-project 项目执行迁移，给 users 表添加一个 created_at 列。
找出我数据库里最慢的几条查询并解释它们的执行计划。

工具能力 34

list_projects 只读

列出您账户中前 10 个 Neon 项目。

list_shared_projects 只读

列出与当前用户共享的 Neon 项目。

describe_project 只读

获取特定 Neon 项目的详细信息。

create_project 写入

在 Neon 账户中创建新项目。

delete_project 破坏性

删除现有 Neon 项目及其所有资源。

list_organizations 只读

列出当前用户可访问的组织。

create_branch 写入

在指定 Neon 项目中创建新分支。

delete_branch 破坏性

删除 Neon 项目中的现有分支。

展开其余 26 个工具

describe_branch 只读

获取特定分支的详细信息。

list_branch_computes 只读

列出项目或分支的计算端点。

compare_database_schema 只读

显示子分支与父分支之间的模式差异。

reset_from_parent 破坏性

将当前分支重置为父分支状态。

get_connection_string 只读

获取数据库连接字符串。

run_sql 写入

执行单个 SQL 查询。

run_sql_transaction 写入

在单笔交易中执行一系列 SQL 查询。

get_database_tables 只读

列出指定数据库中的所有表。

describe_table_schema 只读

获取特定表的模式定义。

prepare_database_migration 写入

开始数据库迁移，创建临时分支进行安全测试。

complete_database_migration 写入

完成数据库迁移，合并到主分支并清理临时资源。

list_slow_queries 只读

找出数据库中最慢的查询。

explain_sql_statement 只读

提供 SQL 查询的详细执行计划。

prepare_query_tuning 写入

分析查询性能并建议优化，创建临时分支进行测试。

complete_query_tuning 写入

完成查询优化，应用或丢弃优化。

provision_neon_auth 写入

为 Neon 项目提供认证基础设施。

configure_neon_auth 写入

配置现有 Neon Auth 集成。

get_neon_auth_config 只读

读取 Neon Auth 配置。

provision_neon_data_api 写入

提供 HTTP 访问数据库的 Data API。

search 只读

跨组织、项目和分支搜索。

fetch 只读

获取特定实体的详细信息。

query_logs 只读

查询无服务器函数日志。

list_log_fields 只读

列出可过滤的日志字段。

list_log_field_values 只读

列出日志字段的不同值。

list_docs_resources 只读

列出所有可用的 Neon 文档页面。

get_doc_resource 只读

获取特定文档页面内容。

使用场景

使用自然语言创建和管理 Neon 项目及分支。

通过对话执行 SQL 查询和事务。

无需手动编写 SQL 即可运行数据库迁移。

分析查询性能并优化慢查询。

配置 Neon Auth 和 Data API。

支持客户端

Claude Desktop

Cursor

VS Code

Claude Code

Kiro

依据项目文档列出，未经本站实测。

详细介绍

Neon MCP Server 是 Neon 官方提供的开源工具，它通过自然语言让您能够与 Neon 上的 Lakebase Postgres 数据库进行交互。它充当自然语言请求与 Neon API 之间的桥梁，将您的请求转换为必要的 API 调用，从而可以管理项目、分支、运行查询、执行数据库迁移等操作。支持远程托管服务和本地开发，提供 OAuth 和 API 密钥认证方式。