mcp-neo4j-server-sse-java

mcp-neo4j-server-sse-java

mcp-neo4j-server-sse-java 是一个使用 Java 实现的 MCP 服务，通过 SSE（Server-Sent Events）服务传输或 STDIO 传输作为传输协议。

概述

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

此项目展示了：

• 与 spring-ai-mcp-server-webflux-spring-boot-starter 集成
• 支持 SSE（Server-Sent Events）和 STDIO 两种传输方式
• 使用 Spring AI 的 @Tool 注解自动注册工具

提示词

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

• 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-java.git

2. 构建项目

• Java 17+

cd mcp-neo4j-server-sse-java

mvn clean install -DskipTests

3. 运行服务

• WebFlux SSE 模式（默认）
  • spring.ai.mcp.server.stdio（默认）：false
  • 服务 IP（默认）：0.0.0.0
  • 服务端口（默认）：8543
  • Neo4j URI（默认）：neo4j://localhost:7687
  • Neo4j 用户名（默认）：neo4j
  • Neo4j 密码（默认）：neo4j
  • Neo4j 数据库（默认）：neo4j

java -jar target/mcp-neo4j-server-sse-java-1.0-SNAPSHOT.jar

• STDIO 模式

要启用 STDIO 传输，请设置相应的属性：

java -Dspring.ai.mcp.server.stdio=true \
     -Dspring.main.web-application-type=none \
     -Dneo4j.uri=neo4j://localhost:7687 \
     -Dneo4j.username=neo4j \
     -Dneo4j.password=<your password> \
     -Dneo4j.database=<your database> \
     -Dlog.path=/absolute/path/to/ \
     -jar target/mcp-neo4j-server-sse-java-1.0-SNAPSHOT.jar

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

已发布的软件包

将此服务添加到你的 cline_mcp_settings.json 中。

• WebFlux SSE 模式（默认）

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

• STDIO 模式

{
  "mcpServers": {
    "neo4j-local": {
      "disabled": false,
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-Dspring.main.web-application-type=none",
        "-Dneo4j.uri=neo4j://localhost:7687",
        "-Dneo4j.username=neo4j",
        "-Dneo4j.password=<your password>",
        "-Dneo4j.database=<your database>",
        "-Dlog.path=/absolute/path/to/",
        "-jar",
        "/absolute/path/to/mcp-neo4j-server-sse-java-1.0-SNAPSHOT.jar"
      ],
      "transportType": "stdio"
    }
  }
}

将 /absolute/path/to/ 替换为构建后的 jar 文件或日志文件的实际路径。

许可证

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