zepai/knowledge-graph-mcp

Graphiti Knowledge Graph MCP Server

概述

Graphiti Knowledge Graph MCP Server 是一个基于 Graphiti 构建的知识图谱管理控制平面（Management and Control Plane, MCP）服务器。该镜像提供知识图谱的核心管理能力，需配合 Neo4j 图数据库使用，实现知识图谱数据的存储、查询与管理。

核心功能与特性

• 知识图谱数据管理：支持知识图谱实体、关系的创建、查询、更新与删除（CRUD）操作。
• Graphiti 框架集成：基于 Graphiti 框架实现知识图谱模型定义与数据验证。
• Neo4j 数据持久化：与 Neo4j 图数据库深度集成，依赖其进行数据存储与高效图查询。
• REST API 服务：提供标准化 RESTful API，支持外部系统调用知识图谱功能。
• 配置化部署：通过环境变量灵活配置数据库连接、服务端口等参数。

使用场景与适用范围

• 企业知识管理系统：构建企业内部知识图谱，支持业务知识的结构化存储与查询。
• 智能问答平台：作为后端知识图谱服务，支撑智能问答系统的语义理解与答案推理。
• 学术研究工具：用于科研领域知识图谱构建，如文献关系分析、领域本体管理。
• 数据分析与决策支持：通过知识图谱关联多源数据，辅助复杂业务决策。

使用方法

前置条件

• 已安装 Docker 或 Docker Compose。
• 部署并运行 Neo4j 服务器（支持 Neo4j 4.x/5.x 版本），确保网络可通。

Docker Run 示例

通过 docker run 命令直接启动，需指定 Neo4j 连接参数：

bash
docker run -d \
  --name graphiti-mcp-server \
  -p 8080:8080 \
  -e NEO4J_URI=bolt://neo4j-host:7687 \
  -e NEO4J_USER=neo4j \
  -e NEO4J_PASSWORD=your-neo4j-password \
  graphiti/knowledge-graph-mcp-server:latest

参数说明：

• -p 8080:8080：映射 MCP 服务器端口（容器内默认 8080）。
• NEO4J_URI：Neo4j 连接地址（bolt 协议，格式为 bolt://<host>:<port>）。
• NEO4J_USER：Neo4j 登录用户名（默认 neo4j）。
• NEO4J_PASSWORD：Neo4j 登录密码（必填，需与 Neo4j 配置一致）。

Docker Compose 示例

通过 Docker Compose 编排 MCP Server 与 Neo4j，简化部署：

yaml
version: '3.8'

services:
  neo4j:
    image: neo4j:5.15
    container_name: neo4j-server
    environment:
      - NEO4J_AUTH=neo4j/your-neo4j-password  # 设置 Neo4j 用户名/密码
    ports:
      - "7474:7474"  # Neo4j Web 界面
      - "7687:7687"  # Neo4j Bolt 协议端口
    volumes:
      - neo4j-data:/data  # 持久化 Neo4j 数据
    restart: unless-stopped

  mcp-server:
    image: graphiti/knowledge-graph-mcp-server:latest
    container_name: graphiti-mcp-server
    depends_on:
      - neo4j  # 确保 Neo4j 启动后再启动 MCP Server
    ports:
      - "8080:8080"
    environment:
      - NEO4J_URI=bolt://neo4j:7687  # 容器内通过服务名访问 Neo4j
      - NEO4J_USER=neo4j
      - NEO4J_PASSWORD=your-neo4j-password  # 需与 Neo4j 配置一致
      - MCP_SERVER_PORT=8080  # MCP 服务端口（默认 8080）
      - LOG_LEVEL=INFO  # 日志级别（DEBUG/INFO/WARN/ERROR，默认 INFO）
    restart: unless-stopped

volumes:
  neo4j-data:  # 定义 Neo4j 数据卷

启动命令：docker-compose up -d

配置参数

MCP Server 通过环境变量配置，支持以下核心参数：

注意事项

• Neo4j 版本兼容性：建议使用 Neo4j 4.4+ 或 5.x 版本，确保与 MCP Server 兼容。
• 网络配置：若 Neo4j 与 MCP Server 分属不同容器/主机，需确保 NEO4J_URI 可访问（如使用主机 IP 或 Docker 网络别名）。
• 数据持久化：通过 Docker 卷（Volume）持久化 Neo4j 数据，避免容器重启导致数据丢失。