使用说明
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连接详细信息:
-
使用单个连接字符串:
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中设置Neo4j MCP服务器:
- 打开光标设置
- 导航到功能>MCP服务器
- 点击“+添加新MCP服务器”按钮
- 填写以下信息:
- 名称:输入服务器的昵称(例如“neo4j mcp”)
- 类型:选择“command”作为类型
- 命令:输入运行服务器的命令:
重要提示:用实际的Neo4j数据库凭据替换凭据。env=NEO4J_URI=your-neo4j-uri,NEO4J_USER=your-neo4j-user,NEO4J_PASSWORD=your-neo4j-password npx -y @neobarrientos/neo4j_mcpserver
可用工具🛠️
neo4j查询
对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
许可证
国际协调委员会