【免费下载链接】mcp-server-neonMCP server for interacting with Neon Management API and databases项目地址https://gitcode.com/gh_mirrors/mc/mcp-server-neon点击查看免费下载Neon MCP Server是 Neon 官方开源的 MCP Server让你用自然语言对话的方式管理 NeonLakebase Postgres数据库创建项目和分支、执行 SQL、跑数据库迁移、做查询调优全程不需要手写 SQL 或调用 API。本文给出 3 个新手可直接照做的实战案例并附上完整安装配置步骤。它是什么一个会聊天的数据库管家Neon MCP Server 基于 Model Context ProtocolMCP 协议构建充当自然语言与 Neon Management API 之间的桥梁你说的话会被翻译成对应的 API 调用。它对 MCP 客户端Cursor、Claude Code、VS Code 等暴露了 100 多个工具按功能分为 14 个类别类别category能做什么代表工具projects项目增删查list_projects、create_projectbranches分支/角色/库管理create_branch、reset_from_parentendpoints计算端点启停start_postgres_endpoint、suspend_postgres_endpointschema查看表结构get_database_tables、describe_table_schemaquerying执行 SQLrun_sql、get_connection_stringobservability查询日志等query_logs、list_slow_queriesdocs搜索官方文档search_docs、get_doc……还有 snapshots、neon_auth、storage、realtime 等见下文工具目录的完整定义在 mcp/tools/ 下生成的 Management API 工具适配层在 mcp/tools/generated/adapt.ts。最快安装步骤3 种接入方式任选方式一一条命令搞定推荐新手npx neonlatest init这条命令会自动完成 OAuth 登录、创建 API Key并配置好 Cursor、VS Code、Claude Code 中的 MCP Server。方式二连接远程托管服务免本地安装Neon 托管的 MCP 服务地址是https://mcp.neon.tech/mcp支持 OAuth 授权npx add-mcp https://mcp.neon.tech/mcp?categoryprojectscategorybranchescategoryendpointscategoryqueryingcategoryschema也可以直接把下面这段写进客户端的 MCP 配置文件如mcp.json{ mcpServers: { Neon: { type: http, url: https://mcp.neon.tech/mcp?categoryprojectscategorybranchescategoryendpointscategoryqueryingcategoryschema } } }保存后刷新客户端浏览器会弹出 OAuth 授权窗口确认后即可使用。category参数可以按需裁剪工具范围只给 AI 它真正需要的能力。方式三API Key 认证适合无浏览器的环境在 Neon Console 创建 API Key 后通过请求头认证{ mcpServers: { Neon: { url: https://mcp.neon.tech/mcp, headers: { Authorization: Bearer 你的NEON_API_KEY } } } } 前提条件一个 MCP 客户端 一个 Neon 账号本地开发还需要 Node.js 18。实战案例 1像聊天一样建库建表配置完成后直接在对话里说人话帮我新建一个 Postgres 数据库名字叫 my-database然后建一张 users 表包含 id、name、email、password 四列。AI 会按以下顺序调用工具create_project—— 创建项目并等待默认计算端点就绪get_connection_string—— 获取连接串仅在有写权限时可用run_sql—— 执行建表语句CREATE TABLE users ( id BIGINT PRIMARY KEY GENERATED ALWAYS AS IDENTITY, name TEXT NOT NULL, email TEXT UNIQUE NOT NULL, password TEXT NOT NULL );全程你不需要知道project_id是什么AI 会自己解析。建表实现逻辑位于 mcp/tools/handlers/fetch.ts 与 SQL 执行相关的 mcp/tools/handlers/ 目录中。想随时确认状态继续问总结一下我所有 Neon 项目每个项目里有什么数据对应工具是list_projectsdescribe_branch后者会返回该分支上的数据库、schema、表、视图和函数树实现在 mcp/tools/handlers/decribe-project.ts。实战案例 2用临时分支安全跑迁移改表结构最怕改坏线上库。Neon 的分支能力 MCP 的双段式迁移流程天然解决这个问题在 my-project 上跑一个迁移给 users 表加一列 created_at。流程分两步由两个专用工具协作完成阶段工具作用开始prepare_database_migration自动创建一个临时分支在里面应用迁移验证AI 自由测试在临时分支上跑测试、查数据确认无误提交complete_database_migration把迁移合并回主分支并清理临时资源关键设计在于迁移先在隔离的临时分支上彩排确认通过后才落到主分支。想撤销临时分支被丢弃即可主分支毫发无损。这个开始/提交的两段式交互提示定义在 mcp/tools/registration.ts。实战案例 3慢查询诊断与调优闭环性能优化也能一句话启动。常用组合拳找瓶颈——list_slow_queries列出最慢的查询依赖pg_stat_statements扩展看执行计划——explain_sql_statement给出详细 EXPLAIN 计划定位缺索引的全表扫描一键体检——inspect_database运行 15 项预置只读诊断索引使用率、顺序扫描、缓存命中率、autovacuum 膨胀估算、活跃查询与锁等实现见 mcp/tools/handlers/inspect-database.ts诊断项定义在 mcp/inspect/queries.ts安全试优化——prepare_query_tuning同样先建临时分支试验加索引等优化方案验证有效后用complete_query_tuning应用到主分支不满意则直接丢弃。例如直接说我的 checkout 页面很慢帮我找到最慢的查询并给出加索引的建议。 AI 会自动走完上面 1→4 的流程。授权与权限控制给 AI 的权限最小化第一次用 OAuth 连接时浏览器会打开授权确认页。这里能精细控制 AI 能碰什么可以控制三个维度工具类别只勾选querying、schema等需要的类别建库建分支的工具根本不会暴露给 AI项目范围全部项目或锁定单个项目读写权限选 Read only 时写操作类工具建项目、建分支、迁移等全部禁用run_sql也会强制包在READ ONLY事务里执行。除了页面勾选还可以直接在 URL 上用参数固化授权改 URL 需重新授权参数作用示例readonly只读模式?readonlytrueprojectId锁定单个项目?projectIdproj-123category限制工具类别?categoryqueryingcategoryschemaroleName指定 SQL 以某 Postgres 角色执行?roleNameapp_reader参数化 URL 的授权确认页长这样——权限一目了然点 Approve 生效roleName是最值得记住的一招比如给 AI 只授予SELECT权限的app_reader角色那么即使 AI想删表Postgres 自身也会拒绝。角色相关逻辑见 mcp/utils/read-only.ts。想预览某个配置下会暴露哪些工具无需登录直接调/api/list-tools接口即可路由实现在 app/api/list-tools/route.ts。安全注意事项务必阅读⚠️ 官方建议仅用于本地开发和 IDE 集成不建议用于生产环境执行前始终审查 AI 请求的操作再授权尤其是delete_project、reset_from_parent这类破坏性操作只读模式下run_sql_transaction不可用多条语句需逐条用run_sql执行不共享事务。项目结构速览源码在哪里目录说明mcp/tools/全部 MCP 工具定义、处理器与注册逻辑mcp/oauth/授权事务、同意页、角色固定等 OAuth 逻辑app/api/[transport]/route.ts无状态 Streamable HTTP 端点/mcpapp/api/authorize/OAuth 授权流程端点lib/oauth/OAuth 客户端、客户端断言等底层实现mcp/inspect/inspect_database的 15 项诊断查询与报告ai-notes/OAuth 回调 SLO、刷新 SLO 等设计笔记想本地跑起来贡献代码corepack enable pnpm install pnpm dev测试金字塔单元/集成/E2E命令都在 README.md 的 Development 一节。小结场景一句话提示词背后工具建库建表新建 my-database 并建 users 表create_project→run_sql安全迁移给 users 加 created_at 列prepare_database_migration→complete_database_migration性能调优找出慢查询并给索引建议list_slow_queries→prepare_query_tuningNeon MCP Server 的价值在于把数据库运维降维成对话临时分支负责安全授权页负责权限你只负责提出需求。赞分享【免费下载链接】mcp-server-neonMCP server for interacting with Neon Management API and databases项目地址https://gitcode.com/gh_mirrors/mc/mcp-server-neon点击查看免费下载相关推荐MCP Toolbox AI模型集成数据库智能查询生成MCP Toolbox AI模型集成数据库智能查询生成 1. 痛点与解决方案概述 你是否还在为复杂的数据库查询语法而困扰是否希望通过自然语言直接生成精准的SMCP 服务AI 应用数据库后端Macro 数据库开发实战SQLx 查询、迁移、测试与查询计划调优Macro 数据库开发实战SQLx 查询、迁移、测试与查询计划调优 本文以 Macro 仓库的数据库开发指南为主线系统梳理在 Macro一个集成邮件、聊天后端前端协同办公即时通讯企业应用CRMAI Agent人工智能Attu让向量数据库管理变得像聊天一样简单Attu让向量数据库管理变得像聊天一样简单 还记得第一次接触向量数据库时的困惑吗那些复杂的命令、繁琐的参数配置让人望而却步。现在有了Attu一切都变得上一篇PixelBoard运行时钩子深扒扩展APK如何桥接Gboard内部API的完整指南下一篇Thomson-1.0-Small是什么一文读懂Thomson Reuters开放权重专业AI的完整入门指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考