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！