Neo4j Mcpserver

Neo4j MCP服务器实现，通过Model Context Protocol管理图数据库操作，兼容Cursor和Claude Desktop，支持Cypher查询执行。

数据库开发者工具 #图数据库 #Cypher查询 #MCP协议本地 .JavaScript

评分 : 2.5分

下载量 : 15

更新时间 : 2025-04-28

什么是Neo4j MCP Server?

Neo4j MCP Server是一个中间件服务，允许您通过标准化的Model Context Protocol(MCP)与Neo4j图数据库进行交互。它简化了数据库操作，使您可以在Cursor或Claude Desktop等开发环境中直接执行Cypher查询。

如何使用Neo4j MCP Server?

您可以通过简单的命令行安装或直接使用npx运行服务器。配置好Neo4j连接信息后，即可在支持的客户端中执行数据库操作。

适用场景

适合需要在开发环境中快速访问Neo4j数据库的开发者，特别是使用Cursor或Claude Desktop进行图数据库开发的场景。

主要功能

Cypher查询执行直接执行Cypher查询语句并返回结果

多环境支持支持通过环境变量或.env文件配置不同环境的连接信息

Cursor集成无缝集成到Cursor开发环境中，提供流畅的开发体验

优势与局限性

优势

简单易用的命令行接口

灵活的连接配置方式

与流行开发工具深度集成

无需编写额外代码即可执行查询

局限性

目前仅支持基本查询功能

需要预先配置Neo4j连接信息

高级数据库操作可能需要直接使用Neo4j驱动

如何使用

安装服务器

可以通过npm全局安装或直接使用npx运行

配置数据库连接

设置Neo4j连接信息，可以通过环境变量或.env文件

在Cursor中配置

在Cursor设置中添加MCP服务器配置

执行查询

在支持的客户端中直接输入Cypher查询语句

使用案例

简单数据查询查询数据库中的前5个节点

创建新节点创建一个带有属性的新Person节点

复杂关系查询查找所有与特定节点有两度关系的节点

常见问题

如何验证我的Neo4j连接信息是否正确?

为什么我的查询没有返回结果?

如何在不同项目中使用不同的数据库配置?

服务器支持哪些Neo4j版本?

🚀 Neo4j MCP 服务器

Neo4j MCP 服务器用于通过模型上下文协议管理图数据库操作，并且🔌 兼容 Cursor 和桌面版 Claude！

🚀 快速开始

你可以直接使用 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 的连接信息：

使用单个连接字符串：

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 设置
点击功能 > MCP 服务器
点击“+ 添加新 MCP 服务器”按钮
填写以下信息：
- 名称：输入一个服务器的昵称（例如，“neo4j-mcp”）
- 类型：选择“命令”作为类型
- 命令：输入运行服务器的命令：
```
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 [仓库地址]
cd [项目目录]

安装依赖项：
```
npm install
```
启动服务器：
```
npm start
```
运行测试：
```
npm test
```

📄 许可证

MIT License

版权所有 (c) [年份] [作者姓名]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.