MCP Rawr Graphiti

Graphiti MCP Server是一个基于官方getzep/graphiti的多项目知识图谱服务器扩展，支持多服务器单数据库配置，提供开发者友好的CLI工具，能够为每个项目构建临时知识图谱，供AI代理通过模型上下文协议查询。

知识管理与记忆开发者工具 #知识图谱 #多项目 #AI代理 #Neo4j .Python

评分 : 2分

下载量 : 13

更新时间 : 2025-04-29

什么是Graphiti MCP服务器？

Graphiti MCP服务器是一种用于将无结构文本转化为时间序列知识图谱的强大工具。它通过语言模型提取实体和关系，并记录每个更改作为时间戳事件，从而支持版本化的查询。

如何使用Graphiti MCP服务器？

只需几个简单的步骤即可启动并运行Graphiti MCP服务器。首先安装CLI工具，然后生成Docker Compose文件，接着启动服务，最后初始化您的项目。

适用场景

适合需要跨多个项目管理和查询知识图谱的应用场景，例如企业知识管理、AI助手开发等。

主要功能

多项目支持允许多个项目共享同一个Neo4j数据库，同时保持完全隔离。

时间序列图谱记录每个变更的时间戳，支持版本化的查询。

自动发现与配置自动生成IDE所需的MCP配置文件，简化集成过程。

优势与局限性

优势

支持多项目隔离，避免冲突。

提供零停机维护能力。

易于集成到现有的IDE和AI框架中。

局限性

对于小型项目可能显得过于复杂。

需要一定的技术背景来设置和维护。

如何使用

安装CLI工具

通过pipx安装Graphiti MCP服务器的CLI工具。

生成Docker Compose文件

运行graphiti compose命令生成Docker Compose配置文件。

启动服务

使用graphiti up -d命令启动服务。

初始化新项目

在项目的根目录下运行graphiti init命令初始化新项目。

使用案例

创建知识图谱使用Graphiti MCP服务器创建一个知识图谱。

启动服务启动Graphiti MCP服务器的服务。

常见问题

如何确保多项目之间的隔离性？

是否可以只运行一个服务器？

如何安全地清除整个知识图谱？

🚀 图形表示图

本项目提供了图形表示图相关的功能，可用于定义和管理多个 Graphiti MCP 服务实例，帮助用户更高效地进行项目开发和管理。

🚀 快速开始

克隆仓库并配置环境

git clone https://github.com/rawr-ai/mcp-graphiti.git
cd mcp-graphiti
cp .env.example .env   # 复制示例环境文件

⚠️ 重要安全提示

如果 NEO4J_PASSWORD 设置为 'password'，服务将拒绝启动，除非明确设置 GRAPHITI_ENV=dev。

除开发环境外，请使用强密码。

安装 CLI 工具

pipx install . --include-deps   # 用户推荐方式
# 或者对于贡献者：
python -m venv .venv && source .venv/bin/activate && pip sync uv.lock && pip install -e .

启动服务

graphiti compose   # 生成 docker-compose 文件
graphiti up -d     # 启动服务

📦 项目结构

mcp-graphiti/
├── .env.example
├── docker-compose.yml
├── mcp-projects.yaml
├── README.md
└── graphiti/
    ├── main.py
    └── ...

💻 使用示例

创建项目

cd ~/code
graphiti init acme-support-bot   # 在新项目的根目录运行
cd acme-support-bot
# 添加实体 YAML 文件到 ai/graph/entities/ 目录下

📚 详细文档

项目配置 (`mcp-projects.yaml`)

该文件用于定义和管理多个 Graphiti MCP 服务实例。

💡 使用建议

列出所有项目，指定根目录路径和其他配置。

默认情况下，mcp-projects.yaml 被加入 .gitignore 文件，避免误提交到版本控制。

私有项目管理：请从本地 .gitignore 文件中删除 mcp-projects.yaml。

运行 graphiti compose 生成 docker-compose.yml 配置文件。

单服务与多服务 FAQ

问题	答案
可以否合并到一个服务？	是的，移除 `mcp-projects.yaml` 中的项目或设置 `MCP_SINGLE_SERVER=true` 并重新运行 `compose`。
隔离仅通过端口实现吗？	不是，每个查询包含 `group_id`；额外容器提供崩溃和依赖隔离。
可否添加网关？	当然可以，任何 API 网关或反向代理均可注入 `group_id` 并路由到根服务。