适合谁
- 已经运行 Neo4j 实例并希望用自然语言查询的开发者
- 使用 Claude Desktop、VS Code、Cursor、Windsurf 或 Gemini CLI 等 MCP 客户端的用户
- 希望将图数据库接入 LLM 工作流的团队
- 愿意接受实验室级实验性功能并自行承担维护责任的使用者
N
56FMRS · C
Neo4j Cypher MCP 服务器是 Neo4j Labs 计划中的实验性 MCP 服务器，由 Neo4j Field GenAI 团队开发维护，可将自然语言转换为 Cypher 查询并针对 Neo4j 数据库执行读写操作。它通过 PyPI 上的 mcp-neo4j-cypher 包（0.6.0 版本）分发，支持 STDIO、SSE 和 Streamable HTTP 传输。使用前提是 Neo4j 实例安装并启用 APOC 插件。由于属于 Labs 项目，它不受 Neo4j 产品团队官方支持，也没有 SLA 或向后兼容保证；使用者应自行评估写入操作对数据的影响，并妥善保管 NEO4J_PASSWORD 等凭据。
Neo4j Cypher MCP 服务器是 Neo4j Labs 系列 MCP 服务器之一，由 Neo4j Field GenAI 团队开发和维护，属于实验性项目，不受 Neo4j 产品团队官方支持，也不提供 SLA 或向后兼容保证。该服务器获取所配置数据库的 schema，并可在该数据库上执行生成的读写 Cypher 查询。通过模型上下文协议，用户可以借助自然语言让 Claude Desktop、VS Code、Cursor、Windsurf、Gemini CLI 等 MCP 客户端与 Neo4j 图数据库交互。注意：schema 检查功能要求 Neo4j 实例安装并启用 APOC 插件。该服务器通过 PyPI 包 mcp-neo4j-cypher（版本 0.6.0）分发，支持 STDIO、SSE 和 Streamable HTTP 传输模式。
安装接入
- 在 Neo4j 实例上安装并启用 APOC 插件（schema 检查所必需）。
- 安装 PyPI 包 mcp-neo4j-cypher（版本 0.6.0）。
- 配置必需的环境变量：NEO4J_URI（连接 URI）、NEO4J_USERNAME（用户名）、NEO4J_PASSWORD（密码）。
- 按需配置可选环境变量：NEO4J_DATABASE（数据库名）、NEO4J_NAMESPACE（工具命名空间前缀）、NEO4J_RESPONSE_TOKEN_LIMIT（读查询响应的最大 token 数）、NEO4J_READ_TIMEOUT（读查询超时秒数）、NEO4J_READ_ONLY（是否仅允许只读查询）、NEO4J_SCHEMA_SAMPLE_SIZE（schema 采样大小）。
- 默认使用 STDIO 传输；如需 HTTP 模式，可使用 --transport http 参数并配合 --host、--port、--path 选项，或设置 NEO4J_TRANSPORT、NEO4J_MCP_SERVER_HOST、NEO4J_MCP_SERVER_PORT、NEO4J_MCP_SERVER_PATH 环境变量。
- 在 MCP 客户端中添加该服务器并开始使用。
选型与风险
不适合谁
- 需要官方产品级支持、SLA 或向后兼容保证的生产用户
- 无法安装或启用 APOC 插件的 Neo4j 实例（schema 检查将不可用）
- 只想使用受官方支持的 Neo4j MCP 服务器的用户
- 没有可访问 Neo4j 实例或数据库凭据的用户
所需权限
- 读取所配置的 Neo4j 数据库及其 schema
- 在所配置的 Neo4j 数据库上执行读写 Cypher 查询
- 访问 Neo4j 所需凭据，包括 NEO4J_URI、NEO4J_USERNAME 和敏感的 NEO4J_PASSWORD
风险与副作用
- 该服务器属于 Neo4j Labs 实验性项目，不提供 SLA 或向后兼容保证，可能随版本更新发生变化
- 默认情况下可执行写 Cypher 查询，可能修改或删除数据库中的数据
- NEO4J_PASSWORD 为敏感信息，配置不当可能造成凭据泄露
- 该服务器未由 Neo4j 产品团队官方支持
- 若以 HTTP/SSE 模式部署在网络中，可能存在未授权访问风险
常见排障
- 确认 Neo4j 实例已安装并启用 APOC 插件，否则 schema 检查功能不可用
- 检查 NEO4J_URI、NEO4J_USERNAME、NEO4J_PASSWORD 是否正确配置
- 确认是否设置了 NEO4J_DATABASE；未设置时可能使用默认数据库
- 查看 NEO4J_READ_TIMEOUT，读查询超时可能由该配置过短导致
- 若响应被截断，检查 NEO4J_RESPONSE_TOKEN_LIMIT 设置
- 若写查询失败，确认 NEO4J_READ_ONLY 是否被设置为 true
- HTTP 模式下检查 NEO4J_MCP_SERVER_HOST、NEO4J_MCP_SERVER_PORT、NEO4J_MCP_SERVER_PATH 是否与客户端配置一致
使用场景
用自然语言查询 Neo4j 图数据库中的数据
获取所配置数据库的 schema 信息
在 Neo4j 数据库上执行生成的读 Cypher 查询
在 Neo4j 数据库上执行生成的写 Cypher 查询
让 AI 助手基于图数据库内容回答问题（例如图中有什么）
支持客户端
Claude Desktop完整支持
VS Code部分支持
Cursor部分支持
Windsurf部分支持
Gemini CLI部分支持