图数据库管理服务

Neo4j MCP Server是一个通过Model Context Protocol管理图数据库操作的服务,适用于需要高效处理图数据的开发场景。

  • by Tobarrientos2
  • JavaScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 tobarrientos2/neo4j-mcpserver

使用说明

Neo4j MCP服务器

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连接详细信息:

  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中设置Neo4j MCP服务器:

  1. 打开光标设置
  2. 导航到功能>MCP服务器
  3. 点击“+添加新MCP服务器”按钮
  4. 填写以下信息:
    • 名称:输入服务器的昵称(例如“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查询

对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

许可证

国际协调委员会