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的连接信息：

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. 点击功能 > MCP 服务器
3. 点击“+ 添加新 MCP 服务器”按钮
4. 填写以下信息：
   • 名称：输入一个服务器的昵称（例如，“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

故障排除 🔧

如果你遇到问题：

1. 验证 Neo4j 凭据

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

2. 路径问题

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

3. 工具检测问题

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

开发 👩💻

从仓库克隆项目后，按照以下步骤进行开发：

1. 克隆仓库：

   git clone [仓库地址]
   cd [项目目录]
   

2. 安装依赖项：

   npm install
   

3. 启动服务器：

   npm start
   

4. 运行测试：

   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.