Graphiti MCP Server

Graphiti MCP 服务

分叉自 getzep/graphiti 示例，专注于提升开发者体验并支持多个项目。Graphiti 从文本中提取实体和关系，并将其存储在 Neo4j 中。本仓库新增了一个命令行工具，可在 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  # fill in Neo4j credentials and your OpenAI key
   

2. 启动服务

   graphiti compose   # generates docker-compose.yml and updates .cursor/mcp.json
   graphiti up -d
   

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

   cd /path/to/my-kg
   graphiti init my-kg        # writes ai/graph/mcp-config.yaml
   # add entity definitions under ai/graph/entities/
   

   在任意位置重新运行 graphiti compose && graphiti up -d，即可启动该项目的容器。

启动后，你可以：

• 查看 http://localhost:8000/graphiti/status。
• 将兼容 MCP 的工具连接到 http://localhost:800{N}/sse。
• 使用 .env 中的凭据浏览 Neo4j：http://localhost:7474。

安全提示

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

为什么选择这个分支？

上游仓库假定每个 compose 文件对应一个服务。在这里，单个 compose 文件可以管理多个共用 Neo4j 的项目服务。每个服务都有自己的 group_id、实体和模型，因此各个项目彼此隔离，同时共用同一个数据库。

亮点

• 项目隔离 —— 不同的提取规则或模型互不冲突。
• 编辑器自动发现 —— 端口会写入 .cursor/mcp.json。
• 崩溃隔离 —— 一个有问题的提示词只会重启其容器。
• 热重载 —— 修改项目配置，然后运行 graphiti reload <container>。

如果只需要根服务，请将 mcp-projects.yaml 留空。

危险操作

设置 NEO4J_DESTROY_ENTIRE_GRAPH=true 后，下次运行 graphiti up 时会清除所有项目。请谨慎使用。

参与贡献

欢迎提交 PR 和问题反馈。

© 2025 rawr‑ai • MIT 许可证