Neo4j MCP Server for Cursor

Neo4j MCP Server for Cursor

site icon
2025.03.16 1
TypeScript数据库服务开发工具数据库
Neo4j MCP Server 是一个为 Cursor IDE 设计的 MCP(Model Context Protocol)服务器,用于实现与 Neo4j 数据库的无缝交互。它提供了连接 Neo4j 数据库、执行 Cypher 查询、转换数据格式等功能,并支持通过环境变量管理安全凭证。
View on GitHub

Overview

基本能力

产品定位

Neo4j MCP Server 是一个专为 Cursor IDE 设计的 MCP 服务器,用于与 Neo4j 数据库进行交互。

核心功能

  • 连接 Neo4j 数据库
  • 执行 Cypher 查询并获取结果
  • 将 Neo4j 特定数据类型转换为标准 JavaScript 对象
  • 使用官方 MCP SDK 和 stdio 传输实现与 Cursor 的无缝集成
  • 支持环境变量管理安全凭证
  • 获取详细的数据库信息和指标
  • 监控连接状态和诊断

适用场景

  • 在 Cursor IDE 中直接操作 Neo4j 数据库
  • 开发需要与 Neo4j 交互的应用程序
  • 数据库管理和监控

工具列表

  1. Connect to Neo4j with Explicit Credentials:使用提供的凭证连接 Neo4j 数据库。
  2. Connect to Neo4j with Environment Variables:使用环境变量中的凭证连接 Neo4j 数据库。
  3. Execute a Cypher Query:在连接的 Neo4j 数据库上执行 Cypher 查询。
  4. Get Database Information:获取连接的 Neo4j 数据库的详细信息。
  5. Get Connection Status:获取当前连接状态。
  6. Disconnect from Neo4j:断开与 Neo4j 数据库的连接。

常见问题解答

  • 如何配置环境变量?在项目根目录创建 .env 文件并设置相关变量。
  • 如何启动服务器?可以使用 bun run index.ts./run-mcp-server.sh 脚本启动。

使用教程

使用依赖

  • 安装 Bun (v1.0.0 或更高版本)
  • 安装 Neo4j 数据库(本地或远程)

安装教程

  1. 克隆仓库: bash git clone https://github.com/yourusername/neo4j-mcp.git cd neo4j-mcp
  2. 安装依赖: bash bun install
  3. 配置环境变量:在项目根目录创建 .env 文件并设置以下变量: NEO4J_URI=neo4j://localhost:7687 NEO4J_USERNAME=neo4j NEO4J_PASSWORD=your_password NEO4J_DATABASE=neo4j NODE_ENV=development

调试方式

  • 启动服务器: bash bun run index.ts 或使用脚本: bash ./run-mcp-server.sh
  • 检查日志文件 logs/mcp-server.log 以获取运行信息。

许可证

该项目遵循 MIT 开源许可条款。