Neon MCP ServerNeon MCP Server
Neon 官方 MCP server(MIT):agent 管 Neon 项目、建分支、跑 SQL。 特色是分支模型——agent 可以在库副本上试改动;但默认连接面照旧, 按「它能执行 SQL、管理 key 能删项目」设防。诚实标注:旧 docs 路径 404,现役以仓为准。
Neon's official MCP server (MIT): agents manage Neon projects, create branches, run SQL. The signature is the branch model — agents can try changes on a copy; but the default connection surface is unchanged, so defend as if it can execute SQL and the management key can delete projects.
适合与不适合When to use it, when not to
适合:Neon/serverless Postgres 栈的 agent 开发流、分支隔离试验。 不适合:非 Neon 的 Postgres;要硬只读边界。
Fits: agent dev flows on Neon/serverless Postgres, branch-isolated experiments. Not a fit: non-Neon Postgres (it manages its own platform); hard read-only boundaries.
中文生态China availability 国产 / 国内可直接用 / 备案状态 · 快照domestic / direct access / CAC filing · snapshot 2026-10-21
- 出品属地Origin
- 国外出品foreign-made Neon, Inc.(美国,现归 Databricks——vendor 口径按官方现行主体写 Neon)。Neon, Inc. (US; now under Databricks — the vendor line follows Neon as the current official product owner).
- 国内使用Direct access
- 直连不可达direct blocked github.com 直连实测 000(波动,同日代理可达 200);neon.com 直连未单独测。github.com measured 000 direct (fluctuating; 200 via proxy the same day); neon.com not individually measured.
- 备案状态CAC filing
- 未见于备案名单not in filing list:未见于网信办公示名单(2026-10-21 检索);该产品未面向大陆公众提供服务,备案不适用。not in the CAC public registry (searched 2026-10-21); the product does not serve the mainland public, so filing does not apply.
备案信息以网信办《生成式人工智能服务已备案信息》公示名单为准(按批次滚动更新,本站只抄编号不解读);「大陆可直连」是本站从大陆网络直连实测的结果,不是厂商承诺。GitHub 类站点当日实测有波动,口径写在依据里。Filing status is quoted from the CAC public registry (updated batch by batch; this site copies the number and does not interpret it). "Direct access" is this site's own reachability measurement from a mainland network, not a vendor promise. GitHub-hosted sites fluctuated on the measurement day — the note says so.
固定坐标系Fixed coordinate system
11 个维度dimensions, 与同分区其他对象逐项可比each comparable item by item against others in the same section.
- 模型与开放条件Model & openness
它自己不调模型——被 MCP 客户端调用的接口实现。它把 Neon(serverless Postgres) 的管理 API 与数据库操作包装成工具给 agent 用。
It calls no model itself — an interface implementation called by MCP clients. It wraps Neon's (serverless Postgres) management API and database operations as tools for agents.
- 运行位置Where it runs
本地进程(npx stdio)+ 官方托管远程线;GitHub 659★,最近推送 2026-10-29(API 核验)。 旧 docs 路径(neon.com/docs/ai-and-mcp/mcp-server)直抓 404——现役以仓为准。
A local process (npx stdio) + an official hosted remote line; GitHub 659★, last push 2026-10-29 (API verified). The old docs path (neon.com/docs/ai-and-mcp/mcp-server) direct-fetched 404 — the current line is the repo itself.
- 本地文件Local files
不读写本机项目文件——作用域是 Neon 云端项目/分支与数据库。
Reads and writes no local project files — the scope is Neon cloud projects/branches and databases.
- 关机后的任务Tasks after shutdown
stdio 随客户端生死;Neon 的分支(branch)能力是它特色——agent 可建库分支做隔离试验。
stdio lives and dies with the client; Neon's branch capability is its signature — an agent can create database branches for isolated experiments.
- 工具与扩展Tools & extensions
项目管理、分支创建/删除、数据库查询执行、schema 查看等;写能力齐全 (建分支、执行 SQL)。完整清单以仓 README 为准。
Project management, branch create/delete, database query execution, schema inspection, etc.; write capabilities are complete (create branches, execute SQL). The complete inventory follows the repo README.
- 上下文与记忆Context & memory
无跨会话记忆——状态在 Neon 项目本身。
No cross-session memory — state lives in the Neon project itself.
- 权限与限制Permissions & limits
两条凭据:Neon API key(管理面:项目/分支)+ Postgres 连接串(数据面:SQL)。 Neon 的分支模型给了「agent 在副本上试」的隔离玩法——但默认连主分支时写面照旧, 按「它能执行 SQL」设防。
Two credentials: a Neon API key (management surface: projects/branches) + a Postgres connection string (data surface: SQL). Neon's branch model enables the "agent tries things on a copy" isolation play — but when connected to the main branch by default the write surface is unchanged; defend on the assumption "it can execute SQL".
- 适合什么任务Best for
适合:Neon 栈的 agent 开发流(建分支→试改→合并)、serverless Postgres 管理接 agent。 不适合:非 Neon 的 Postgres(它管自家平台);要硬只读边界。
Fits: agent dev flows for the Neon stack (create branch→try changes→merge), hooking serverless Postgres management into an agent. Not a fit: non-Neon Postgres (it manages its own platform); hard read-only boundaries.
- 传输方式Transport
stdio(npx)为主 + 官方托管远程线(细节以仓 README 为准,未逐条核验)。 核验:仓与 GitHub API(2026-10-21)。
stdio (npx) is primary + an official hosted remote line (details follow the repo README, not verified item by item). Verified: the repo and GitHub API (2026-10-21).
- 认证机制Authentication
Neon API key(管理面)+ Postgres 连接串(数据面)两路线。
Two routes: Neon API key (management surface) + Postgres connection string (data surface).
- 权限范围Permission scope
管理面:项目/分支增删查;数据面:SQL 执行(含写/DDL)。 无工具级审批机制的官方说明;分支模型是结构性隔离手段而非审批层。
Management surface: project/branch add/delete/query; data surface: SQL execution (including writes/DDL). No official docs for a tool-level approval mechanism; the branch model is a structural isolation means, not an approval layer.
头号误解Top misconception
- 找 neon.com/docs/ai-and-mcp/mcp-server——该路径 404(2026-10-21 直抓),现役以 neondatabase 仓为准Looking for neon.com/docs/ai-and-mcp/mcp-server — that path 404s (direct-fetched 2026-10-21); the live line is the neondatabase repo
- 把「分支隔离」当默认安全——默认操作面跟着连接配置走,主分支照写不误Treating 'branch isolation' as safe by default — the operating surface follows connection config; the main branch still gets writes
- 管理 key 与数据连接串两权限面混配——管理面能删项目,数据面能改数据Mixing the management key with the data connection string — the management surface can delete projects; the data surface changes data
未知项清单Known unknowns
- 远程托管端点状态(未逐条核验)
- 工具全清单(未逐条清点)
- Databricks 收购后产品口径变化细节(未逐条核验——vendor 按现行官方主体写)
- The status of the hosted remote endpoint (not verified item by item)
- The full tool inventory (not enumerated item by item)
- Details of product-wording changes after the Databricks acquisition (not verified item by item — the vendor line follows the current official owner)
证据来源Evidence sources
判断可回到以下一手源复核。本站核验日Every judgement can be rechecked against the primary sources below. Verified on 2026-10-30,内容更新日content updated on 2026-10-21。
| 类型Type | 名称Name | 链接Link |
|---|---|---|
| repo | neondatabase/mcp-server-neon · 仓库(MIT;659★,最近推送 2026-10-29,GitHub API 核验)neondatabase/mcp-server-neon · repository (MIT; 659★, last push 2026-10-29, GitHub API verified) | https://github.com/neondatabase/mcp-server-neon |
| changelog | neondatabase/mcp-server-neon · Releases(changelog)neondatabase/mcp-server-neon · Releases (changelog) | https://github.com/neondatabase/mcp-server-neon/releases |
| docs | Neon · 官方文档首页(产品背景)Neon · official docs home (product background) | https://neon.com/docs |
实测记录Measured runs
本档未在真实客户端逐项跑通;工具清单与权限来自官方 README。
This site has not completed measured runs. The test protocol is at protocols/mcp/_protocol.md.
相关条目Related entries
- Supabase MCPSupabase MCP同为 BaaS 数据库 server:Supabase 项目面更宽,Neon 的分支隔离是结构差异点。Both BaaS database servers: Supabase's project surface is broader, Neon's branch isolation is the structural differentiator.
- CursorCursor另一层 · AI 编程Other layer · AI coding
- Claude Code IDE 扩展Claude Code (IDE extension)另一层 · AI 编程Other layer · AI coding
本页由This page is generated from the ai-handbook 数据层生成(CC BY 4.0)。data layer (CC BY 4.0).
方法论与坐标系定义见仓库内For the methodology and coordinate definitions, see METHODOLOGY.md.