Graphiti MCP 服务器

getzep/graphiti 的一个分支，专注于开发者体验和多项目支持。Graphiti 从文本中提取实体和关系，并将其存储在 Neo4j 中。此仓库添加了一个 CLI，可以在 Docker 中启动根服务器以及特定项目的 MCP 服务器，使得多个知识图谱可以共享同一个数据库。

快速开始

1. 安装并克隆

   pipx install 'git+https://github.com/rawr-ai/mcp-graphiti.git'
   git clone https://github.com/rawr-ai/mcp-graphiti.git
   cd mcp-graphiti
   cp .env.example .env  # 填写 Neo4j 凭证和你的 OpenAI 密钥
   

2. 启动服务

   graphiti compose   # 生成 docker-compose.yml 并更新 .cursor/mcp.json
   graphiti up -d
   

   根服务器运行在端口 8000；项目容器从 8001 开始。
3. 创建项目

   cd /path/to/my-kg
   graphiti init my-kg        # 写入 ai/graph/mcp-config.yaml
   # 在 ai/graph/entities/ 下添加实体定义
   

   从任何地方重新运行 graphiti compose && graphiti up -d 来启动其容器。

运行后你可以：

• 检查 http://localhost:8000/graphiti/status。
• 将兼容 MCP 的工具连接到 http://localhost:800{N}/sse。
• 使用 .env 文件中的凭证通过 http://localhost:7474 浏览 Neo4j。

安全提示

如果 NEO4J_PASSWORD 仍为 password，除非设置 GRAPHITI_ENV=dev，否则服务器拒绝启动。生产环境中始终使用强密码。

为什么是这个分支？

上游仓库假设每个组合文件只有一个服务器。这里一个组合文件管理许多项目服务器，它们共享 Neo4j。每个服务都有自己的 group_id、实体和模型，因此项目在同一个数据库上运行时保持隔离。

高亮

• 项目隔离 – 不同的提取规则或模型永远不会冲突。
• 编辑器自动发现 – 端口被写入 .cursor/mcp.json。
• 故障隔离 – 错误提示只会重启其容器。
• 热重载 – 调整项目的配置并运行 graphiti reload <container>。

如果你只需要根服务器，可以将 mcp-projects.yaml 留空。

危险区域

设置 NEO4J_DESTROY_ENTIRE_GRAPH=true 将在下次运行 graphiti up 时删除 所有 项目。谨慎使用。

贡献

欢迎提交 PR 和问题。

© 2025 rawr-ai • MIT 许可证