返回 MCP 目录
public公开dns本地运行

neo4j-mcp-server-776

Neo4j MCP服务器是一个支持环境变量配置的知识图谱存储服务,兼容模型上下文协议。

article

README

🚀 Neo4j MCP 服务器

Neo4j 模型上下文协议 (MCP) 服务器的一个分支版本,此版本增加了对环境变量的支持,同时对配置选项进行了优化,为用户带来更便捷的使用体验。

🚀 快速开始

若要启动该服务器,你可以按照以下步骤进行操作:

# 安装依赖
npm install

# 构建
npm run build

# 启动服务器
npm start

✨ 主要特性

  • 使用环境变量配置 Neo4j 连接,让配置过程更加灵活便捷。
  • 支持自定义端口和远程 Neo4j 实例,满足不同场景的使用需求。
  • 改进了错误处理和日志记录,方便排查问题和监控系统运行状态。
  • 兼容 模型上下文协议,具备良好的通用性。

📦 安装指南

服务器可以通过以下环境变量进行配置:

  • NEO4J_URL - Neo4j 连接 URL(默认:bolt://localhost:7687
  • NEO4J_USER - Neo4j 用户名(默认:neo4j
  • NEO4J_PASSWORD - Neo4j 密码(默认:neo4j

配置示例如下:

NEO4J_URL="bolt://192.168.0.157:28687" \
NEO4J_USER="neo4j" \
NEO4J_PASSWORD="your-password" \
node dist/servers/mcp-neo4j-memory/main.js

💻 使用示例

可用工具 - mcp-neo4j-memory

存储在 Neo4j 中的知识图谱内存,具备以下实用功能:

  • create_entities - 创建知识图谱中的多个新实体
  • create_relations - 在实体之间创建关系(主动语态)
  • add_observations - 为现有实体添加新的观察结果
  • delete_entities - 删除实体及其关系
  • delete_observations - 从实体中删除特定的观察结果
  • delete_relations - 删除特定的关系
  • read_graph - 读取整个知识图谱
  • search_nodes - 根据查询搜索节点
  • open_nodes - 打开特定名称的节点

📚 详细文档

变更日志(相对于上游)

  • 添加了对 Neo4j 连接详细信息的环境变量支持,简化配置流程。
  • 改进了错误处理和连接管理,增强系统稳定性。
  • 增加了详细的日志记录以备调试,方便开发人员排查问题。
  • 更新配置以支持远程 Neo4j 实例,拓展使用场景。

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端