Neon Serverless Postgres 全生命周期自动化:基于 awesome-claude-skills 的 Composio MCP 实战指南 AI 技能AI 插件人工智能工作流自动化【免费下载链接】awesome-claude-skillsA curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows项目地址https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills点击查看免费下载本指南围绕 composio-skills/neon-automation/SKILL.md 展开系统讲解如何借助 Composio 的 Rube MCP 集成让 Claude 等 Agent 直接完成 Neon 云数据库的项目、分支、数据库、角色与连接串的日常运维。读完本文你将掌握 9 个 Neon 工具槽tool slug的调用参数、完整的端到端操作链路以及 5 类高频踩坑点的规避方法可以直接把 Neon 数据库操作接入自己的 Agent 工作流。技能定位Neon 运维的 Agent 化封装Neon 是一个 serverless PostgreSQL 云平台其核心资源模型分为四层项目Project→ 分支Branch→ 数据库Database→ 角色Role。传统运维需要登录控制台逐层点选而neon-automation这一 Claude Skill 把这套操作封装成了可被 Agent 直接调用的工具序列。该技能文件以标准 Claude Skills 格式编写YAML frontmatter 声明name、description与requires.mcp: [rube]说明它依赖 Rube MCP 服务器提供真实工具能力。这与 README.md 中定义的技能体系一致技能本身只定义做什么、按什么顺序做、有哪些护栏真正的连接与执行能力由 MCP 提供。README 的App Automation via Composio一节也明确这类预构建工作流技能使用从 Composio API 发现的真实工具槽涵盖 78 个 SaaS 应用Neon 正是其中之一。技能覆盖的操作范围包括列出项目与分支、查看项目配置与消费指标盘点分支下的数据库与角色生成带凭据的 Postgres 连接 URI将数据库操作编排进跨应用流水线例如新环境就绪后自动创建分支并生成连接串再写入内部 Wiki环境搭建三步接入 Rube MCP按照技能文档的 Setup 部分接入分为三步添加 MCP 服务器在客户端Claude Code、Claude.ai 或其他支持 MCP 的客户端的 MCP 配置中添加端点https://rube.app/mcp。Rube 是 Composio 的托管 MCP 网关添加端点即可使用无需单独安装插件。连接 Neon 账号按提示完成 Neon 账号授权认证方式为 API key 认证。开始调用工作流连接成功后即可按下文各工作流调用对应工具。关于连接状态的确认可参照同目录下 composio-skills/composio-automation/SKILL.md 给出的通用流程先调用RUBE_SEARCH_TOOLS确认 MCP 可用并获取当前工具 schema再通过RUBE_MANAGE_CONNECTIONS检查 Neon 连接状态只有状态为ACTIVE时才可执行工具。该文档还强调两条通用纪律同样适用于 Neon永远先搜索工具 schema工具签名会变化不要硬编码工具槽名与参数同一次工作流内复用 session_id跨工作流则生成新会话保持上下文隔离。核心工作流六个典型操作以下六个工作流是技能文档的主体均以工具槽 输入参数形式给出可直接照搬使用。1. 列出项目NEON_RETRIEVE_PROJECTS_LIST用于发现当前认证用户关联的全部 Neon 项目是绝大多数工作流的起点。参数类型说明org_idstring使用个人 API key 时必填团队场景视配置决定limitinteger单页返回条数范围 1-400默认 10cursorstring分页游标取自上一次响应的返回字段searchstring按项目名称或 ID 搜索支持部分匹配timeoutinteger毫秒级超时超时返回部分结果关键提醒使用个人 API key 时org_id必须提供否则该工具返回 HTTP 400 错误详见下文陷阱表。首次调用前先用NEON_GET_USER_ORGANIZATIONS取回用户所属组织列表从中获得org_id。2. 获取项目详情NEON_ACCESS_PROJECT_DETAILS_BY_ID用于查看单个项目的配置、所有者信息与消费指标consumption metrics适合做资源盘点或成本核查。参数类型说明project_idstring必填。Neon 项目 ID 采用adjective-noun-number格式例如dry-smoke-262582713. 列出项目分支NEON_GET_BRANCHES_FOR_PROJECT分支对应 Neon 中的开发阶段development stage例如 main 分支、preview 分支、修复分支等。此工具枚举项目内的全部分支。参数类型说明project_idstring必填searchstring可选按分支名称或 ID 搜索4. 列出分支上的数据库NEON_FETCH_DATABASE_FOR_BRANCH对指定项目与分支内的数据库进行清单化盘点常用于确认某分支下是否存在目标库。参数类型说明project_idstring必填branch_idstring必填指定分支5. 获取连接 URINEON_GET_PROJECT_CONNECTION_URI这是技能中实用价值最高的工具为指定项目/分支/数据库生成 Postgres 连接字符串供 Agent 或外部程序直连使用。参数类型说明project_idstring必填database_namestring必填数据库名例如neondbrole_namestring必填角色名例如neondb_ownerbranch_idstring可选默认使用项目默认分支endpoint_idstring可选默认使用读写read-write端点pooledboolean可选为 true 时在主机名中追加-pooler以启用连接池安全红线返回的 URI 中包含数据库凭据必须将其视为机密。不要写入日志、不要在对话中明文展示、不要共享给无关方。Agent 拿到连接串后若需持久化应放入密钥管理系统。6. 检查数据库详情与角色NEON_RETRIEVE_BRANCH_DATABASE_DETAILS / NEON_GET_BRANCH_ROLES_FOR_PROJECT连接数据库前的体检两步NEON_RETRIEVE_BRANCH_DATABASE_DETAILS核对数据库是否存在、元数据与设置是否符合预期避免对不存在的库发起连接NEON_GET_BRANCH_ROLES_FOR_PROJECT列出分支上可用的角色用于挑选合法的role_name。工具参数NEON_RETRIEVE_BRANCH_DATABASE_DETAILSproject_id必填、branch_id必填、database_name必填NEON_GET_BRANCH_ROLES_FOR_PROJECTproject_id必填、branch_id必填已知陷阱与规避方案技能文档用一张表格总结了五个高频问题是实战中最值得先读的部分完整继承如下陷阱细节规避方法缺少 org_id使用个人 API key 时NEON_RETRIEVE_PROJECTS_LIST返回 HTTP 400 org_id is required先调用NEON_GET_USER_ORGANIZATIONS取得组织 ID 再传参分页不完整不翻页时项目列表可能不完整循环迭代cursor参数直至其返回空值为止触发限流突发式连续列表请求会触发 HTTP 429避免冗余调用重试前进行退避back off角色/数据库配对无效NEON_GET_PROJECT_CONNECTION_URI在database_name/role_name配对不合法时返回 401/403先用NEON_GET_BRANCH_ROLES_FOR_PROJECT查询允许的角色再组合连接串即机密返回 URI 含凭据永不明文记录、展示或分享端到端编排从零交付一个可连接数据库将上述工作流串联即可形成一条完整的数据库交付流水线这也是技能文档在核心工作流之外隐含的编排模式NEON_GET_USER_ORGANIZATIONS→ 取得org_id个人 API key 场景NEON_RETRIEVE_PROJECTS_LIST带org_id→ 找到目标项目project_idNEON_GET_BRANCHES_FOR_PROJECT→ 确认或找到目标分支branch_idNEON_FETCH_DATABASE_FOR_BRANCH→ 确认目标数据库存在NEON_GET_BRANCH_ROLES_FOR_PROJECT→ 选取合法角色名NEON_GET_PROJECT_CONNECTION_URI→ 生成连接串并安全存储。这套链路可以嵌入更上层的工作流例如配合 connect/SKILL.md 中Agent 执行真实动作的模式在环境创建完成后自动把连接串写入 Notion 或发送到 Slack 频道实现数据库供给的端到端自动化而不再停留于生成一段 SQL 建议的文本层面。工具快速参考技能文档末尾的快速参考表汇总了全部 9 个相关工具槽是 Agent 判断哪个工具能做什么的索引完整列出如下工具槽描述NEON_RETRIEVE_PROJECTS_LIST列出全部 Neon 项目支持分页与搜索NEON_ACCESS_PROJECT_DETAILS_BY_ID获取项目配置与消费指标NEON_GET_BRANCHES_FOR_PROJECT列出项目内分支NEON_FETCH_DATABASE_FOR_BRANCH列出指定分支上的数据库NEON_GET_PROJECT_CONNECTION_URI获取 Postgres 连接 URI含凭据NEON_RETRIEVE_BRANCH_DATABASE_DETAILS检查数据库元数据与设置NEON_GET_USER_ORGANIZATIONS列出当前认证用户的组织NEON_CREATE_API_KEY_FOR_ORGANIZATION为组织创建新的 API keyNEON_GET_BRANCH_ROLES_FOR_PROJECT列出分支上可用的角色后续深入路径技能原文composio-skills/neon-automation/SKILL.md本指南所有工具参数、陷阱与参考表均出自该文件Composio 系技能的通用调用纪律先搜索 schema、检查连接 ACTIVE、RUBE_MULTI_EXECUTE_TOOL中始终携带memory参数composio-skills/composio-automation/SKILL.mdClaude Skills 的整体概念、安装方式如放置到~/.config/claude-code/skills/与技能格式规范README.md将数据库操作接入跨应用流水线的通用连接模式connect/SKILL.md实际接入时请记住三条底线个人 API key 必须携带org_id连接 URI 一经生成即视为机密工具 schema 可能更新任何重要调用前先通过RUBE_SEARCH_TOOLS获取最新签名。赞分享AI 技能AI 插件人工智能工作流自动化【免费下载链接】awesome-claude-skillsA curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows项目地址https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills点击查看免费下载相关推荐基于 Rube MCP 与 Composio 的 Blackbaud 自动化实战指南awesome-claude-skills基于 Rube MCP 与 Composio 的 Blackbaud 自动化实战指南awesome claude skills 本篇指南以 awesomeAI 技能AI 插件人工智能工作流自动化使用 Rube MCP 与 Composio 自动化 Brilliant Directories基于 awesome-claude-skills 的实战指南使用 Rube MCP 与 Composio 自动化 Brilliant Directories基于 awesome claude skills 的实战指南AI 技能AI 插件人工智能工作流自动化awesome-claude-skills 中的 Google Super 自动化基于 Rube MCP 与 Composio 的 Claude Skill 实战指南awesome claude skills 中的 Google Super 自动化基于 Rube MCP 与 Composio 的 Claude SkillAI 技能AI 插件人工智能工作流自动化上一篇Nacos Naming 领域规范解读服务发现的资源模型、双服务类型语义与接口边界naming-spec下一篇easy-vibe 进阶实战在手机上远程驱动 Claude Code 的 7 种方案与安全实践创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考