
zepai/knowledge-graph-mcpGraphiti Knowledge Graph MCP Server 是一个基于 Graphiti 构建的知识图谱管理控制平面(Management and Control Plane, MCP)服务器。该镜像提供知识图谱的核心管理能力,需配合 Neo4j 图数据库使用,实现知识图谱数据的存储、查询与管理。
通过 docker run 命令直接启动,需指定 Neo4j 连接参数:
bashdocker 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 编排 MCP Server 与 Neo4j,简化部署:
yamlversion: '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_URI | Neo4j 连接地址(bolt 协议) | 无 | 是 |
NEO4J_USER | Neo4j 登录用户名 | neo4j | 否 |
NEO4J_PASSWORD | Neo4j 登录密码 | 无 | 是 |
MCP_SERVER_PORT | MCP 服务器监听端口 | 8080 | 否 |
LOG_LEVEL | 日志输出级别 | INFO | 否 |
GRAPHITI_CONFIG | Graphiti 框架配置文件路径 | /app/config | 否 |
NEO4J_URI 可访问(如使用主机 IP 或 Docker 网络别名)。manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务