Neo4j Cypher MCP Server

社区

针对 Neo4j 数据库运行 Cypher 查询的 MCP 服务器。

分类: 数据库第 28 / 58
Stars: ★ 988 非常热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Python
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 45 天前

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 等凭据。

最强项 · 维护活跃度 13/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

11/20

维护活跃度

13/20

文档质量

12/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 清单声明 stdio 传输、PyPI 包 mcp-neo4j-cypher 0.6.0，README 描述了 schema 获取与 Cypher 读写执行等能力，与清单描述一致，happy path 可信。但本次审查仅见清单与仓库级 README，未提供 servers/mcp-neo4j-cypher 子目录的源码、测试或 CI 工作流证据，无法验证工具列表是否与真实实现一致、错误处理是否可控。静态校准规定：无提交测试与真实 CI 覆盖关键路径时可靠性不得超过 12，故扣分至 8。
安全与权限 11/20: 清单将 NEO4J_PASSWORD 正确标注为 isSecret，属于基本凭据处理；但 NEO4J_READ_ONLY 仅为可选环境变量，默认未披露为只读，意味着默认允许写 Cypher（含潜在删除操作），且 README 未说明写操作是否需要人工确认，存在危险副作用未确认的缺口。此外连接指向外部 Neo4j 实例/URI，数据边界与出网行为未在可见材料中说明。未发现恶意代码、窃取凭据、隐蔽外传、硬编码真实令牌或伪造身份等红线行为，故不落入 0-4 区间；但权限最小化与确认机制不完整，给 11。
维护活跃度 13/20: 仓库为 Neo4j Labs 项目，MIT 许可证明确，版本号 0.6.0 且清单声明持续发布，stars 980、开放 issue 25、未归档，表明仍在活跃开发。但 README 明确声明不提供 SLA、不保证向后兼容，且非官方产品团队支持，治理与安全响应通道（SECURITY.md 等）未在可见材料中出现；子服务器版本的发布节奏与依赖更新证据缺失。综合给 13。
文档质量 12/20: 仓库级 README 覆盖了用途、四个服务器概览、stdio/SSE/HTTP 传输模式、HTTP 启动参数与相关环境变量示例，并指向云部署指南，安装与配置信息可用。但针对 mcp-neo4j-cypher 的工具参数细节、返回格式、NEO4J_RESPONSE_TOKEN_LIMIT/READ_TIMEOUT/SCHEMA_SAMPLE_SIZE 等限制项、成本与故障排查均需跳转子目录文档，本次可见材料未见该内容，APOC 依赖虽提及但安装排错步骤有限。存在隐藏假设，给 12。
安装易用性 12/20: 安装路径清晰：pip 安装 mcp-neo4j-cypher 后通过 stdio 运行，README 给出 HTTP 模式命令行与环境变量示例，并列出 NEO4J_URI/USERNAME/PASSWORD 三个必填变量，主流客户端（Claude Desktop、VS Code、Cursor 等）被点名支持。但缺少直接可复制的客户端配置片段、未给出 Neo4j 实例准备与 APOC 插件启用的完整步骤，需外部文档配合，属可用但偏手工。静态校准下 setup 上限 15，且无执行证据，给 12。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么连接数据库

适合谁

已经运行 Neo4j 实例并希望用自然语言查询的开发者
使用 Claude Desktop、VS Code、Cursor、Windsurf 或 Gemini CLI 等 MCP 客户端的用户
希望将图数据库接入 LLM 工作流的团队
愿意接受实验室级实验性功能并自行承担维护责任的使用者

不适合谁

需要官方产品级支持、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 模式部署在网络中，可能存在未授权访问风险

安装接入

准备工作

运行环境：Python

NEO4J_URI 必填 Neo4j 连接 URI（如 neo4j://localhost:7687 或 Aura 连接串），来自你的 Neo4j 实例。

NEO4J_USERNAME 必填 Neo4j 数据库用户名，通常为 neo4j。

NEO4J_PASSWORD 必填密钥 Neo4j 数据库密码，属于敏感信息，请妥善保管。

其他可选配置项（10 个）

NEO4J_DATABASE 可选可选，指定 Neo4j 数据库名称，默认数据库可不设置。

NEO4J_NAMESPACE 可选可选，为工具名添加命名空间前缀。

NEO4J_RESPONSE_TOKEN_LIMIT 可选可选，限制读取查询响应的最大 token 数。

NEO4J_READ_TIMEOUT 可选可选，读取查询的超时时间（秒）。

NEO4J_READ_ONLY 可选可选，设为 true 时只允许只读 Cypher 查询。

NEO4J_SCHEMA_SAMPLE_SIZE 可选可选，模式检查时的采样规模。

NEO4J_TRANSPORT 可选可选，设为 http 以启用 HTTP 传输模式（默认 stdio）。

NEO4J_MCP_SERVER_HOST 可选可选，HTTP 模式下的服务器监听地址。

NEO4J_MCP_SERVER_PORT 可选可选，HTTP 模式下的服务器监听端口。

NEO4J_MCP_SERVER_PATH 可选可选，HTTP 模式下的 MCP 端点路径。

在 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 客户端中添加该服务器并开始使用。

验证是否装好

在 MCP 客户端的工具列表中确认出现 mcp-neo4j-cypher 的 Cypher 执行与模式查看工具，然后让助手执行“列出数据库的模式”，若能返回 Neo4j 模式信息则连接成功。需要 APOC 插件已启用。

常见排障

确认 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 是否与客户端配置一致

试试这样问

连接成功后，可以直接对 AI 助手这样说：

这个图数据库里有什么内容？
列出数据库的模式
查询前10个按出现频率排列的节点标签
以只读模式运行一条 Cypher 查询统计所有节点数量

使用场景

用自然语言查询 Neo4j 图数据库中的数据

获取所配置数据库的 schema 信息

在 Neo4j 数据库上执行生成的读 Cypher 查询

在 Neo4j 数据库上执行生成的写 Cypher 查询

让 AI 助手基于图数据库内容回答问题（例如图中有什么）

支持客户端

Claude Desktop

VS Code部分支持

Cursor部分支持

Windsurf部分支持

Gemini CLI部分支持

依据项目文档列出，未经本站实测。

详细介绍

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 传输模式。

同仓库的其他 Server

源版本 1c7ad0793b5f 数据同步于 2026-10-19 查看 FMRS 评分方法