Neon自动化Skill NeonAutomation

Neon自动化技能用于自动化管理Neon服务器less Postgres数据库操作,包括项目、分支、数据库的列举和配置,获取连接URI,管理角色等,通过Composio MCP集成支持跨应用工作流自动化。关键词:Neon自动化,Postgres管理,数据库自动化,服务器less数据库,Composio集成,云计算自动化。

Serverless 0 次安装 0 次浏览 更新于 3/12/2026

name: Neon自动化 description: “通过Composio MCP集成自动化Neon服务器less Postgres操作——管理项目、分支、数据库、角色和连接URI。” requires: mcp: - rube

Neon自动化

自动化您的Neon服务器less Postgres工作流程——列举项目和分支、检查数据库、获取连接URI、管理角色,并将Neon数据库操作集成到跨应用管道中。

工具包文档: composio.dev/toolkits/neon


设置

  1. 将Composio MCP服务器添加到您的客户端:https://rube.app/mcp
  2. 在提示时连接您的Neon账户(API密钥认证)
  3. 开始使用以下工作流程

核心工作流程

1. 列举项目

使用NEON_RETRIEVE_PROJECTS_LIST来发现与认证用户关联的所有项目。

工具:NEON_RETRIEVE_PROJECTS_LIST
输入:
  - org_id:字符串(使用个人API密钥时必需)
  - limit:整数(1-400,默认10)
  - cursor:字符串(来自先前响应的分页游标)
  - search:字符串(按项目名称或ID搜索,支持部分匹配)
  - timeout:整数(毫秒;超时返回部分结果)

重要: 使用个人API密钥时,org_id是必需的。首先通过NEON_GET_USER_ORGANIZATIONS检索它。

2. 获取项目详情

使用NEON_ACCESS_PROJECT_DETAILS_BY_ID来检查项目配置、所有者信息和消耗指标。

工具:NEON_ACCESS_PROJECT_DETAILS_BY_ID
输入:
  - project_id:字符串(必需)——格式:"形容词-名词-数字",例如"dry-smoke-26258271"

3. 列举项目的分支

使用NEON_GET_BRANCHES_FOR_PROJECT来枚举项目内的分支(开发阶段)。

工具:NEON_GET_BRANCHES_FOR_PROJECT
输入:
  - project_id:字符串(必需)
  - search:字符串(可选,按分支名称或ID搜索)

4. 列举分支上的数据库

使用NEON_FETCH_DATABASE_FOR_BRANCH来清点特定项目和分支内的数据库。

工具:NEON_FETCH_DATABASE_FOR_BRANCH
输入:
  - project_id:字符串(必需)
  - branch_id:字符串(必需)

5. 获取连接URI

使用NEON_GET_PROJECT_CONNECTION_URI来获取项目/分支/数据库的Postgres连接字符串。

工具:NEON_GET_PROJECT_CONNECTION_URI
输入:
  - project_id:字符串(必需)
  - database_name:字符串(必需)——例如"neondb"
  - role_name:字符串(必需)——例如"neondb_owner"
  - branch_id:字符串(可选,默认为项目默认分支)
  - endpoint_id:字符串(可选,默认为读写端点)
  - pooled:布尔值(可选,添加-pooler用于连接池)

安全: 返回的URI包含凭据。请将其视为秘密——不要记录或分享。

6. 检查数据库详情和角色

使用NEON_RETRIEVE_BRANCH_DATABASE_DETAILS来在连接前验证数据库,并使用NEON_GET_BRANCH_ROLES_FOR_PROJECT来列举可用角色。

工具:NEON_RETRIEVE_BRANCH_DATABASE_DETAILS
输入:
  - project_id:字符串(必需)
  - branch_id:字符串(必需)
  - database_name:字符串(必需)

工具:NEON_GET_BRANCH_ROLES_FOR_PROJECT
输入:
  - project_id:字符串(必需)
  - branch_id:字符串(必需)

已知陷阱

陷阱 详情
org_id必需 使用个人API密钥时,NEON_RETRIEVE_PROJECTS_LIST返回HTTP 400 “org_id is required”。首先调用NEON_GET_USER_ORGANIZATIONS
不完整的分页 项目列表可能在没有分页的情况下不完整。使用cursor迭代直到为空。
速率限制 NEON_RETRIEVE_PROJECTS_LIST在突发列举时返回HTTP 429。避免冗余调用并在重试前退避。
无效的角色/数据库配对 当database_name/role_name配对无效时,NEON_GET_PROJECT_CONNECTION_URI返回401/403。使用NEON_GET_BRANCH_ROLES_FOR_PROJECT来选择允许的角色。
连接URI是秘密 返回的URI包含凭据。切勿以明文记录、显示或分享。

快速参考

工具标识 描述
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密钥
NEON_GET_BRANCH_ROLES_FOR_PROJECT 列举分支上可用的角色

Composio提供支持