适合谁
- 希望使用自然语言管理 Neon 数据库的开发者和非开发者。
- 在 IDE 或聊天界面中快速完成数据库任务的用户。
- 需要安全迁移和查询优化的团队。
N
73FMRS · B
Neon 官方 MCP 服务器，支持远程托管和本地开发，功能丰富，涵盖项目管理、分支、SQL 查询、迁移、优化、认证和数据 API。适合用自然语言管理 Neon 数据库，但需注意安全问题。
Neon MCP Server 是 Neon 官方提供的开源工具，它通过自然语言让您能够与 Neon 上的 Lakebase Postgres 数据库进行交互。它充当自然语言请求与 Neon API 之间的桥梁，将您的请求转换为必要的 API 调用，从而可以管理项目、分支、运行查询、执行数据库迁移等操作。支持远程托管服务和本地开发，提供 OAuth 和 API 密钥认证方式。
工具能力
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 项目中的现有分支。
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
获取特定文档页面内容。
安装接入
- 安装 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"
}
}
}
选型与风险
不适合谁
- 需要精细控制底层的生产环境。
- 需要完整 SQL 界面和复杂事务处理的用户。
- 希望完全离线运行或不依赖远程服务的用户。
所需权限
- 需 Neon 账户和认证（OAuth 或 API 密钥）。
- 访问、创建、修改和删除 Neon 项目、分支、数据库及资源。
- 执行 SQL 查询（读写）。
- 管理认证和 Data API 配置。
- 读取日志和文档索引。
风险与副作用
- 自然语言请求可能误执行破坏性操作（如删除项目或分支）。
- 未经授权的人员可能通过 API 密钥或 OAuth 访问您的账户。
- 生产环境使用有意外变更风险，官方建议仅在本地开发使用。
- 需要谨慎审查 LLM 建议的操作。
常见排障
- 连接失败：检查网络代理或防火墙，并确保客户端支持 streamable-http。
- 认证错误：重新授权 OAuth 或检查 API 密钥是否有效。
- 工具不可用：检查是否启用了只读模式或限制了工具类别。
- 项目访问：确认项目属于您的个人账户或提供了组织 ID。
- IP 白名单：若启用 IP Allow，将 IP 地址 `34.192.103.46` 和 `23.22.233.166` 加入白名单。
使用场景
使用自然语言创建和管理 Neon 项目及分支。
通过对话执行 SQL 查询和事务。
无需手动编写 SQL 即可运行数据库迁移。
分析查询性能并优化慢查询。
配置 Neon Auth 和 Data API。
支持客户端
Claude Desktop完整支持
Cursor完整支持
VS Code完整支持
Claude Code完整支持
Kiro完整支持