MCP Neo4j 服务器

一个 MCP 服务器，提供 Neo4j 图数据库和 Claude Desktop 之间的集成，从而可以通过自然语言交互执行图数据库操作。

<a href="https://glama.ai/mcp/servers/qjpsxn4zlh"><img width="380" height="200" src="https://glama.ai/mcp/servers/qjpsxn4zlh/badge" alt="Neo4j Server MCP server" /></a>

快速开始

您可以使用 npx 直接运行此 MCP 服务器：

npx @alanse/mcp-neo4j

或者将其添加到您的 Claude Desktop 配置中：

{
  "mcpServers": {
    "neo4j": {
      "command": "npx",
      "args": ["@alanse/mcp-neo4j-server"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "your-password"
      }
    }
  }
}

功能

此服务器提供与 Neo4j 数据库交互的工具：

工具

• execute_query: 在 Neo4j 数据库上执行 Cypher 查询

  • 支持所有类型的 Cypher 查询（READ、CREATE、UPDATE、DELETE）
  • 以结构化格式返回查询结果
  • 可以传递参数以防止注入攻击

• create_node: 在图数据库中创建一个新节点

  • 指定节点标签和属性
  • 返回创建的节点及其内部 ID
  • 支持所有 Neo4j 数据类型的属性

• create_relationship: 在两个现有节点之间创建关系

  • 定义关系类型和方向
  • 将属性添加到关系
  • 需要源节点和目标节点的节点 ID

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 MCP Neo4j Server：

npx -y @smithery/cli install @alanse/mcp-neo4j-server --client claude

用于开发

1. 克隆存储库：

git clone https://github.com/da-okazaki/mcp-neo4j-server.git
cd mcp-neo4j-server

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

配置

服务器需要以下环境变量：

• NEO4J_URI: Neo4j 数据库 URI（默认值：bolt://localhost:7687）
• NEO4J_USERNAME: Neo4j 用户名（默认值：neo4j）
• NEO4J_PASSWORD: Neo4j 密码（必需）

使用示例

以下是如何使用自然语言与 Neo4j 数据库交互的示例：

查询数据

您可以提出如下问题：

• "显示销售部门的所有员工"
• "查找前 5 名最老的客户"
• "谁在上个月购买了超过 3 件产品？"

示例：

用户: "显示销售部门的所有员工"

Claude: 让我查询数据库以获取销售部门的员工。

[内部执行查询：MATCH (e:Employee)-[:WORKS_IN]->(d:Department {name: 'Sales'}) RETURN e.name, e.position]

结果:
- John Smith (销售经理)
- Sarah Johnson (销售代表)
- Mike Brown (客户主管)

创建数据

您可以给出如下指令：

• "添加一个名为 John Doe 的新人，他 30 岁"
• "创建一个名为 'Premium Coffee' 的产品，价格为 24.99 美元"
• "添加一个名为 'Research & Development' 的新部门"

示例：

用户: "添加一个名为 John Doe 的新人，他 30 岁"

Claude: 我将创建一个新的 Person 节点，其中包含提供的信息。

[内部创建节点，标签为 'Person'，属性为 {name: 'John Doe', age: 30}]

结果: 创建了新的 person 节点，ID 为：123

创建关系

您可以请求如下关系：

• "让 John Doe 和 Jane Smith 成为朋友"
• "将产品 A 设置为产品 B 的组件"
• "将 John Doe 分配到销售部门"

示例：

用户: "让 John Doe 和 Jane Smith 成为朋友"

Claude: 我将在这两个人之间建立友谊关系。

[内部创建关系：MATCH (a:Person {name: 'John Doe'}), (b:Person {name: 'Jane Smith'})
CREATE (a)-[:FRIENDS_WITH {since: '2024-01-05'}]->(b)]

结果: 在 John Doe 和 Jane Smith 之间建立了友谊关系

复杂操作

您可以使用自然语言执行更复杂的操作：

• "查找居住在纽约的客户购买的所有产品"
• "显示 John Doe 的朋友的朋友"
• "计算每个部门员工的平均年龄"

示例：

用户: "查找居住在纽约的客户购买的所有产品"

Claude: 我将查询数据库以获取此信息。

[内部执行查询：
MATCH (c:Customer {city: 'New York'})-[:PURCHASED]->(p:Product)
RETURN c.name, collect(p.name) as products]

结果:
- Alice Wilson: [Premium Coffee, Tea Set, Cookies]
- Bob Miller: [Premium Coffee, Water Bottle]

测试

运行测试套件：

npm test

许可证

MIT