由 Neon 官方维护的远程 MCP 服务器,允许用户通过自然语言在 IDE 中直接管理 Neon Postgres 数据库、执行查询与探索 Schema。
Neon MCP Server 是 Neon 团队官方推出的数据库智能交互服务,基于 Model Context Protocol (MCP) 构建,部署于 Vercel。该服务作为大语言模型与 Neon Postgres 之间的桥梁,将自然语言指令自动转化为 API 调用,省去了手写 SQL 的步骤。
在核心能力方面,它覆盖了完整的数据库生命周期管理,包括项目与分支的创建删除、SQL 读写执行、Schema 深度探索等。针对高风险操作,服务内置了安全的迁移流和性能调优流,通过临时分支机制保障主库安全。此外,还集成了 Neon Auth 与 Data API 的一键预置功能及官方文档检索能力。
在架构设计上,服务采用 Next.js App Router 构建,支持 Streamable HTTP(推荐)与 SSE 两种传输协议。其安全模型设计精细,支持通过 URL 参数即时切换只读模式、限定项目范围及过滤工具类别,并结合 OAuth 2.0 实现了从授权到撤销的完整闭环。该服务采用 MIT 协议开源,目前主要面向本地开发与 AI IDE 集成场景,已适配 Cursor、VS Code、Claude Code 等主流客户端。
快速开始#
项目主打无需本地安装的远程托管模式,支持三种上手路径:
一键初始化(适用于 Cursor / VS Code / Claude Code):
npx neonctl@latest init
远程服务器 + OAuth(推荐):
npx add-mcp https://mcp.neon.tech/mcp
远程服务器 + API Key:
npx add-mcp https://mcp.neon.tech/mcp --header "Authorization: Bearer <$NEON_API_KEY>"
MCP 客户端配置示例(OAuth):
{
"mcpServers": {
"Neon": {
"type": "http",
"url": "https://mcp.neon.tech/mcp"
}
}
}
动态配置#
通过 URL Query String 实时控制行为,修改后无需重新认证:
readonly:布尔值,开启只读模式projectId:字符串,限定操作项目范围category:字符串,限定工具类别(可多选,如querying、schema)
提供 /api/list-tools 端点供调用方预览当前配置下可见的 MCP 工具列表。
安全与权限#
- 只读模式:通过
?readonly=true或 OAuth scope 限制,禁用所有写操作 - 项目级隔离:通过
?projectId=proj-123将操作限定在单一项目内 - 工具类别过滤:通过
?category=限制暴露给大模型的工具集 - OAuth Scope:支持
read、write、*三种权限级别
待确认信息#
- 当前版本号及发布节奏未在 README 中明确标注
- 是否支持完全本地自托管部署未明确说明
- 远程服务
mcp.neon.tech的 SLA 未在仓库中提及