Neo4j MCP 服务器

一个 Neo4j MCP 服务器实现，用于通过模型上下文协议管理图数据库操作。

🔌 兼容 Cursor 和 Claude Desktop！

快速开始

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

# 使用单个连接字符串
NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password npx neo4j-mcpserver

# 或者使用单独的环境变量
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 连接详细信息：

1. 使用单个连接字符串：

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

2. 使用单独的环境变量：

   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 服务器：

1. 打开 Cursor 设置
2. 导航到 Features > MCP Servers
3. 点击 "+ Add New MCP Server" 按钮
4. 填写以下信息：
   • Name: 输入服务器的昵称 (例如, "neo4j-mcp")
   • Type: 选择 "command" 作为类型
   • 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

故障排除 🔧

如果你遇到问题：

1. 验证 Neo4j 凭据

   • 检查你的 Neo4j URI、用户名和密码是否正确
   • 确保你的 Neo4j 数据库可以访问

2. 路径问题

   • 确保安装路径中没有空格
   • 在路径中使用正斜杠 (/)

3. 工具检测问题

   • 尝试重启 Cursor
   • 验证服务器是否正在运行（检查 Cursor 的 MCP 服务器列表）
   • 检查环境变量是否已正确设置

开发 👩‍💻

要在本地运行：

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

许可证

ISC