Neo4j MCP Server

Name: Neo4j MCP Server
Author: Tobarrientos2

本地服务

github.com/Tobarrientos2数据库489 周前更新

代码仓库

关于 Neo4j MCP Server

Neo4j MCP Server 将 MCP 客户端连接到 Neo4j 图数据库，以便执行 Cypher 查询。它通过 Neo4j 连接凭据配置，并兼容 Cursor 和 Claude Desktop。

主要功能

01对 Neo4j 执行 Cypher 查询
02通过环境变量配置连接
03从 .env 文件加载设置
04兼容 Cursor 和 Claude Desktop

适用场景

01从 MCP 客户端查询图数据
02使用 Cypher 检查节点

MCP 相关

向 MCP 客户端提供 `neo4j-query` 工具，用于对 Neo4j 数据库执行 Cypher 查询。

#neo4j #graph-database #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "neo4j-mcpserver": {
      "command": "npx",
      "args": [
        "-y",
        "neo4j-mcpserver"
      ],
      "env": {
        "NEO4J_CONNECTION": "<NEO4J_CONNECTION>"
      }
    }
  }
}

启动命令npx -y neo4j-mcpserver

需要配置的环境变量

NEO4J_CONNECTION

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmneo4j-mcpserverstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填
pulse	object	是
pulse.name	string	是
pulse.version	string	否
pulse.description	string	否
pulse.isAsync	boolean	否
pulse.isMainPulse	boolean	否
pulse.fileLocation	string	是
entity	string	是
action	string	是
dataStructures	object	否
dataStructures.inputs	array	否
dataStructures.outputs	array	否
relationships	array	否

详细介绍

Neo4j MCP 服务

通过 Model Context Protocol 管理图数据库操作的 Neo4j MCP 服务实现。

🔌 兼容 Cursor 和 Claude Desktop！

快速开始

你可以使用 npx 直接运行服务：

# Using a single connection string
NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password npx neo4j-mcpserver

# Or using separate environment variables
NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io NEO4J_USER=neo4j NEO4J_PASSWORD=your-password npx neo4j-mcpserver

安装

如果你更希望全局安装软件包：

npm install -g neo4j-mcpserver

然后运行：

NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password neo4j-mcpserver

环境变量

你可以通过两种方式提供 Neo4j 连接详情：

使用单个连接字符串：

NEO4J_CONNECTION=<uri>,<user>,<password>

使用单独的环境变量：

NEO4J_URI=<your-uri>
NEO4J_USER=<your-user>
NEO4J_PASSWORD=<your-password>

你也可以在项目根目录中使用 .env 文件：

NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password

配置 ⚙️

配置 Cursor 🖥️

在 Cursor 中设置 Neo4j MCP 服务：

打开 Cursor 设置
前往 Features > MCP Servers
点击“+ Add New MCP Server”按钮
填写以下信息：
- 名称：输入服务的昵称（例如，“neo4j-mcp”）
- 类型：选择“command”作为类型
- 命令：输入运行服务的命令：
```
env=NEO4J_URI=your-neo4j-uri,NEO4J_USER=your-neo4j-user,NEO4J_PASSWORD=your-neo4j-password npx -y @neobarrientos/neo4j_mcpserver
```
重要提示：请将凭据替换为你实际的 Neo4j 数据库凭据。

可用工具 🛠️

neo4j-query

对 Neo4j 数据库执行 Cypher 查询。

在 Cursor 中的用法示例：

MATCH (n) RETURN n LIMIT 5

故障排除 🔧

如果遇到问题：

验证 Neo4j 凭据
- 检查 Neo4j URI、用户名和密码是否正确
- 确保可以访问 Neo4j 数据库
路径问题
- 确保安装路径中没有空格
- 在路径中使用正斜杠（/）
工具检测问题
- 尝试重启 Cursor
- 确认服务正在运行（检查 Cursor 的 MCP 服务列表）
- 检查环境变量是否已正确设置

开发 👩‍💻

在本地运行：

git clone <repository-url>
cd neo4j-mcpserver
npm install
npm run build
npm start

许可证

ISC

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。