neo4j-server-remote

neo4j-server-remote

neo4j-server-remote 是一个 MCP 服务，使用服务器发送事件（SSE）或 STDIO 作为传输协议。

概述

一种模型上下文协议（MCP）服务实现，通过 Neo4j 提供数据库交互和图探索功能。此服务支持执行 Cypher 图查询、分析复杂领域数据，并支持选择可远程访问的数据库。灵感来自 neo4j-contrib/mcp-neo4j。

提示词

此服务提供一个演示提示词：

• mcp-demo：交互式提示词，引导用户执行数据库操作
  • 生成合适的数据库架构和示例数据

工具

此服务提供三个核心工具：

查询工具

• read-neo4j-cypher

  • 执行 Cypher 只读查询，从数据库读取数据
  • 输入：
    • query（字符串）：要执行的 Cypher 查询
  • 返回：由对象组成的数组形式的查询结果

• write-neo4j-cypher

  • 执行用于更新数据的 Cypher 查询
  • 输入：
    • query（字符串）：Cypher 更新查询
  • 返回：结果摘要计数器，格式为 { nodes_updated: number, relationships_created: number, ... }

架构工具

• get-neo4j-schema
  • 获取图数据库中所有节点类型的列表，以及其属性名称、类型和与其他节点类型的关系
  • 无需输入
  • 返回：节点标签列表，以及两个字典，分别用于描述属性和关系

与 Cline 客户端搭配使用

1. 克隆仓库

git clone https://github.com/dsimile/mcp-neo4j-server-sse.git

2. 安装所需软件

• Python 3.12+

cd mcp-neo4j-server-sse

pip install -r requirements.txt

3. 运行服务

• SSE 模式（默认）

使用 UX 命令运行 MCP 服务，并选择所需的数据库。默认 IP 地址为 0.0.0.0，默认端口为 8543。

uv run .\src\mcp-neo4j-cypher\neo4j_server_remote.py --url bolt://localhost:7687 --username neo4j --password neo4j123 --database neo4j

• STDIO 模式

使用 UX 命令在本地运行 MCP 服务，将模式设为 STDIO，并使用相同的 Neo4j 连接信息。

注意：请确保 Neo4j 正在运行且可供远程连接。

已发布的软件包

将服务配置添加到 cline_mcp_settings.json。

• SSE 模式（默认）

{
  "mcpServers": {
    "neo4j-remote": {
      "url": "http://0.0.0.0:8543/sse",
      "disabled": false,
      "autoApprove": []
    }
  }
}

• STDIO 模式

{
  "mcpServers": {
    "neo4j-local": {
      "disabled": false,
      "timeout": 60,
      "command": "uv",
      "args": [
        "run",
        "/absolute/path/to/neo4j_server_remote.py",
        "--url",
        "bolt://localhost:7687",
        "--username",
        "neo4j",
        "--password",
        "neo4j123",
        "--database",
        "neo4j",
        "--mode",
        "stdio"
      ]
    }
  }
}

许可证

此 MCP 服务采用 MIT 许可证。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。