name: Neon自动化 description: “通过Composio MCP集成自动化Neon服务器less Postgres操作——管理项目、分支、数据库、角色和连接URI。” requires: mcp: - rube
Neon自动化
自动化您的Neon服务器less Postgres工作流程——列举项目和分支、检查数据库、获取连接URI、管理角色,并将Neon数据库操作集成到跨应用管道中。
工具包文档: composio.dev/toolkits/neon
设置
- 将Composio MCP服务器添加到您的客户端:
https://rube.app/mcp - 在提示时连接您的Neon账户(API密钥认证)
- 开始使用以下工作流程
核心工作流程
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提供支持