Neo4j Labs MCP 服务器

Neo4j Labs

这些 MCP 服务器是 Neo4j Labs 计划的一部分。 它们由 Neo4j 的现场生成式 AI 团队开发和维护，并欢迎更广泛的开发者社区贡献代码。 这些服务器会频繁更新，加入新的实验性功能，但并不受 Neo4j 产品团队的支持。

它们正在积极开发和维护中，但我们不提供任何服务级别协议（SLA）或关于向后兼容性和弃用的保证。

如果您正在寻找官方的 Neo4j MCP 服务器，请访问 这里。

概述

模型上下文协议（MCP）是一种用于管理大型语言模型（LLM）与外部系统之间上下文的标准化协议。

这使您可以使用 Claude Desktop 或其他 MCP 客户端（VS Code、Cursor、Windsurf、Gemini CLI），通过自然语言与 Neo4j 和您的 Aura 账户交互，完成各种任务，例如：

• 这个图里有什么？
• 根据频率、总量和平均量绘制销售前几名产品的图表
• 列出我的实例
• 在 Aura Professional 中创建一个名为 mcp-test 的新实例，配置 4GB 内存并启用 Graph Data Science 功能
• 存储今天我和 Andreas 以及 Oskar 一起参与了 Neo4j MCP 服务器开发的事实

服务器

mcp-neo4j-cypher - 自然语言到 Cypher 查询

详细信息请参阅 README

获取已配置数据库的模式，并在该数据库上执行生成的读写 Cypher 查询。

要求：需要在 Neo4j 实例上安装并启用 APOC 插件，以便进行模式检查。

mcp-neo4j-memory - 存储在 Neo4j 中的知识图谱记忆

详细信息请参阅 README

在本地或远程 Neo4j 实例中存储和检索您个人知识图谱中的实体和关系。 可以在不同的会话、对话和客户端之间访问这些信息。

mcp-neo4j-cloud-aura-api - Neo4j Aura 云服务管理 API

详细信息请参阅 README

直接从您的 AI 助手聊天界面中管理您的 Neo4j Aura 实例。 可以创建和销毁实例，按名称查找实例，调整实例规模，并启用相关功能。

mcp-neo4j-data-modeling - 交互式图数据建模与可视化

详细信息请参阅 README

创建、验证和可视化 Neo4j 图数据模型。支持从 Arrows.app 导入和导出模型。

传输模式

所有服务器都支持多种传输模式：

• STDIO（默认）：用于本地工具和 Claude Desktop 集成的标准输入输出
• SSE：用于基于 Web 的部署的服务器发送事件
• HTTP：适用于现代 Web 部署和微服务的可流式 HTTP

HTTP 传输配置

要以 HTTP 模式运行服务器，请使用 --transport http 标志：

# 基本 HTTP 模式
mcp-neo4j-cypher --transport http

# 自定义 HTTP 配置
mcp-neo4j-cypher --transport http --host 127.0.0.1 --port 8080 --path /api/mcp/

也可以使用环境变量：

export NEO4J_TRANSPORT=http
export NEO4J_MCP_SERVER_HOST=127.0.0.1
export NEO4J_MCP_SERVER_PORT=8080
export NEO4J_MCP_SERVER_PATH=/api/mcp/
mcp-neo4j-cypher

云部署

此仓库中的所有服务器都已容器化，可直接部署到 AWS ECS Fargate 和 Azure Container Apps 等云平台上。每台服务器都支持专为可扩展、生产就绪的部署设计的 HTTP 传输模式，具备自动伸缩和负载均衡能力。

📋 完整云部署指南 →

部署指南涵盖：

• AWS ECS Fargate：带自动伸缩和应用负载均衡器的分步部署
• Azure Container Apps：内置扩展和流量管理的无服务器容器部署
• 配置最佳实践：安全性、监控、资源建议和故障排除
• 集成示例：将 MCP 客户端连接到云端部署的服务器

贡献

欢迎贡献！请随时提交 Pull Request。

博客文章

• 开发者需要了解的关于模型上下文协议（MCP）的一切
• Claude 通过 MCP 与 Neo4j 对话——图数据库与分析
• 使用 Claude 和 Neo4j 构建知识图谱：无代码 MCP 方法——图数据库与分析
• 在 Gemini CLI 中使用 Neo4j 扩展

许可证

MIT 许可证

mcp-neo4j 快速上手指南

mcp-neo4j 是 Neo4j Labs 推出的一套基于模型上下文协议（MCP）的服务器工具集，旨在让大语言模型（如 Claude、Gemini 等）通过自然语言与 Neo4j 数据库及 Aura 云服务进行交互。

环境准备

系统要求

• 操作系统：Linux, macOS, 或 Windows (WSL2 推荐)
• 运行时环境：Node.js (v18 或更高版本) 或 Python (视具体实现语言而定，通常 MCP 服务器多为 Node/Python)
• Neo4j 实例：
  • 本地运行的 Neo4j 数据库，或
  • Neo4j Aura 云实例
• 前置依赖：
  • 若使用 mcp-neo4j-cypher 进行模式检查，必须在 Neo4j 实例中安装并启用 APOC 插件。
  • 一个支持 MCP 协议的客户端（如 Claude Desktop, Cursor, VS Code, Windsurf 等）。

网络与权限

• 确保运行 MCP 服务器的机器可以访问 Neo4j 数据库端口（默认 7687）和管理端口（默认 7474）。
• 准备好 Neo4j 的连接凭证（URI, 用户名，密码）。

安装步骤

由于该仓库包含多个独立的 MCP 服务器，您可以根据需求选择安装特定的服务。以下以常用的 mcp-neo4j-cypher 为例（假设该项目通过 npm 发布，若为源码运行请参考下方源码方式）。

方式一：通过包管理器安装（推荐）

如果项目已发布到 npm：

npm install -g @neo4j/mcp-neo4j-cypher
# 或者针对其他模块
npm install -g @neo4j/mcp-neo4j-memory
npm install -g @neo4j/mcp-neo4j-cloud-aura-api
npm install -g @neo4j/mcp-neo4j-data-modeling

注：若国内访问 npm 较慢，可配置淘宝镜像源：

npm config set registry https://registry.npmmirror.com

方式二：从源码运行

克隆仓库并安装依赖：

git clone https://github.com/neo4j-labs/mcp-neo4j.git
cd mcp-neo4j

# 进入具体服务器目录，例如 cypher 服务器
cd servers/mcp-neo4j-cypher

# 安装依赖
npm install
# 或者如果是 python 项目
pip install -r requirements.txt

基本使用

1. 配置环境变量

在运行服务器前，需设置 Neo4j 连接信息。以 mcp-neo4j-cypher 为例：

export NEO4J_URI=neo4j://localhost:7687
export NEO4J_USERNAME=neo4j
export NEO4J_PASSWORD=your_password
# 如果使用 Aura 或特定配置，可能还需要设置其他变量

2. 启动服务器

本地模式 (STDIO)

适用于直接配合 Claude Desktop 或本地调试：

npx @neo4j/mcp-neo4j-cypher
# 或者源码运行
node index.js

HTTP 模式

适用于远程部署或微服务架构：

# 使用命令行参数
npx @neo4j/mcp-neo4j-cypher --transport http --host 0.0.0.0 --port 8080

# 或使用环境变量
export NEO4J_TRANSPORT=http
export NEO4J_MCP_SERVER_PORT=8080
npx @neo4j/mcp-neo4j-cypher

3. 连接 MCP 客户端

以 Claude Desktop 为例，修改其配置文件（通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json 或 %APPDATA%\Claude\claude_desktop_config.json），添加如下配置：

{
  "mcpServers": {
    "neo4j-cypher": {
      "command": "npx",
      "args": ["-y", "@neo4j/mcp-neo4j-cypher"],
      "env": {
        "NEO4J_URI": "neo4j://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "your_password"
      }
    }
  }
}

如果是 HTTP 模式部署，客户端配置需指向对应的 SSE 或 HTTP 端点。

4. 开始对话

重启 Claude Desktop 或其他 MCP 客户端后，即可在对话框中使用自然语言操作 Neo4j：

• 查询数据："What is in this graph?"（图中有什么？）
• 生成图表："Render a chart from the top products sold by frequency."（按频率绘制最畅销产品的图表。）
• 管理云资源（需配置 aura-api 服务器）："Create a new instance named mcp-test for Aura Professional with 4GB."（创建一个名为 mcp-test 的 4GB Aura 专业版实例。）
• 记忆存储（需配置 memory 服务器）："Store the fact that I worked on the Neo4j MCP Servers today."（记录我今天参与了 Neo4j MCP 服务器的工作。）

---

注意：本工具集由 Neo4j Field GenAI 团队维护，属于实验性项目，不提供生产环境的 SLA 保证，且可能存在向后兼容性变更。如需官方支持版本，请访问 Neo4j 官方 MCP 服务器仓库。