MCP Rawr Graphiti

🚀 图形表示图

本项目提供了图形表示图相关的功能，可用于定义和管理多个 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

危险区域

设置 NEO4J_DESTROY_ENTIRE_GRAPH=true 将擦除所有项目数据，请谨慎使用。

路线图与贡献

• RAWR CLI 集成：将整个 RAWR 堆栈通过一个顶层命令暴露。
• graphiti prune：一键回收 orphaned group_id 图表的空间。

欢迎 PR 和 Issues！