mcp-neo4j-server-sse-java

mcp-neo4j-server-sse-java

site icon
2025.05.09 0
Java图数据库数据库交互Cypher 查询数据库
mcp-neo4j-server-sse-java 是一个基于 Java 实现的 MCP 服务器,支持使用 SSE(Server-Sent Events)或 STDIO 作为传输协议。该服务器提供了与 Neo4j 数据库的交互能力,支持执行 Cypher 图查询、分析复杂领域数据,并支持选择远程可访问的数据库。
View on GitHub

Overview

基本能力

产品定位

mcp-neo4j-server-sse-java 是一个用于与 Neo4j 数据库交互的 MCP 服务器,提供图数据库查询和操作能力。

核心功能

  • 支持 SSE 和 STDIO 两种传输协议。
  • 提供 Cypher 查询执行能力(读和写)。
  • 支持获取 Neo4j 数据库的 schema 信息。
  • 自动工具注册(通过 Spring AI 的 @Tool 注解)。

适用场景

  • 需要与 Neo4j 数据库交互的应用开发。
  • 复杂领域数据的图分析。
  • 远程数据库访问和管理。

工具列表

  1. read-neo4j-cypher:执行 Cypher 读查询,返回查询结果。
  2. write-neo4j-cypher:执行 Cypher 更新查询,返回操作统计。
  3. get-neo4j-schema:获取数据库的 schema 信息,包括节点类型、属性和关系。

常见问题解答

  • 确保 Neo4j 数据库正在运行并可远程访问。
  • 在 STDIO 模式下,需要正确设置数据库连接参数。

使用教程

使用依赖

  • Java 17+
  • Maven

安装教程

  1. 克隆仓库:
git clone https://github.com/dsimile/mcp-neo4j-server-sse-java.git
  1. 构建项目:
cd mcp-neo4j-server-sse-java
mvn clean install -DskipTests

运行服务器

  • WebFlux SSE 模式(默认)
java -jar target/mcp-neo4j-server-sse-java-1.0-SNAPSHOT.jar
  • 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> \
     -jar target/mcp-neo4j-server-sse-java-1.0-SNAPSHOT.jar

调试方式

  • 确保服务器日志中无错误信息。
  • 使用 cline_mcp_settings.json 配置文件测试服务器连接。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。