适合谁
- 使用 Neo4j Aura 并希望通过对话式助手管理实例的开发者
- 需要快速创建或清理测试用 Aura 实例的团队
- 已经使用 Claude Desktop 或其他 MCP 客户端的用户
N
45FMRS · D
这是一个面向 Neo4j Aura 的实例管理型 MCP 服务器，让 AI 助手通过自然语言完成实例的创建、查询、扩缩和删除，配置简单（STDIO + 两个必填密钥）。它由 Neo4j Field GenAI 团队作为 Labs 项目维护，不属于官方产品支持范围，因此适合个人开发与实验场景，不适合对稳定性和技术支持有要求的生产关键路径；使用时需特别留意高权限 API 凭据的安全。
本服务是 Neo4j Labs 项目中的 MCP 服务器之一，对应仓库子目录 servers/mcp-neo4j-cloud-aura-api，PyPI 包名为 mcp-neo4j-aura-manager，当前版本 0.4.8。它通过 Aura API 连接 Neo4j Aura 控制台，让支持 MCP 的客户端（如 Claude Desktop、VS Code、Cursor、Windsurf、Gemini CLI）直接用自然语言管理 Aura 实例：创建和销毁实例、按名称查找实例、扩缩容量以及启用相关功能。服务采用 STDIO 传输，需要以环境变量形式提供 Aura API 的 Client ID 与 Client Secret，两者均为必填的机密信息。它是 Neo4j Labs 实验性项目，由 Neo4j Field GenAI 团队维护，不受 Neo4j 产品团队支持，也不提供 SLA 或向后兼容性保证；官方产品版 MCP 服务器是另一个仓库 neo4j/mcp。
安装接入
- 在 Neo4j Aura 控制台创建 API 凭据，获取 Client ID 和 Client Secret。2. 在使用的 MCP 客户端中配置该服务器：命令为 uvx mcp-neo4j-aura-manager（或通过 PyPI 包 mcp-neo4j-aura-manager 0.4.8 启动），传输方式为 stdio。3. 设置环境变量 NEO4J_AURA_CLIENT_ID 和 NEO4J_AURA_CLIENT_SECRET；如有需要可设置可选的 NEO4J_NAMESPACE 作为工具命名空间。4. 重启客户端并确认服务器成功启动。
选型与风险
不适合谁
- 寻找 Neo4j 官方产品级支持服务器的用户（应使用 neo4j/mcp）
- 需要 SLA、向后兼容承诺或长期稳定 API 的生产环境
- 不使用 Neo4j Aura 的用户
所需权限
- Neo4j Aura API 凭据（Client ID 与 Client Secret），可创建、修改和删除 Aura 实例
- 对用户 Aura 账户的完整管理权限
风险与副作用
- Aura API 凭据权限较高，泄露后他人可创建、扩容甚至删除实例，进而影响账单与数据可用性
- 模型可能误解自然语言指令，导致误删实例或意外扩容产生费用
- 项目属于 Neo4j Labs 实验性质，可能引入破坏性变更或弃用，无兼容性保证
- Client Secret 若不慎出现在日志或客户端配置中会造成凭据外泄
常见排障
- 确认 NEO4J_AURA_CLIENT_ID 与 NEO4J_AURA_CLIENT_SECRET 已正确设置且未过期
- 检查客户端配置中的命令与包名是否为 mcp-neo4j-aura-manager 版本 0.4.8
- 查看服务器启动日志，确认 STDIO 连接无报错
- 若同时配置多个 Neo4j MCP 服务器导致工具重名，可设置 NEO4J_NAMESPACE 区分
- 验证所使用凭据对应的 Aura 账户是否有目标实例的访问权限
使用场景
列出当前账户下的 Aura 实例
创建指定名称、类型、内存与功能（如 Graph Data Science）的新实例
按名称查找实例
扩缩实例容量
删除不再需要的实例
支持客户端
Claude Desktop部分支持
VS Code部分支持
Cursor部分支持
Windsurf部分支持
Gemini CLI部分支持