MCP Rawr Graphiti

🚀 グラフィティグラフ

このプロジェクトは、グラフィティに関連する機能を提供します。具体的には、グラフィティの管理や操作を行うためのCLIツールやサービスを提供し、複数のGraphiti MCPサービスインスタンスを定義・管理することができます。

🚀 クイックスタート

1. リポジトリをクローンし、環境を設定する

git clone https://github.com/rawr-ai/mcp-graphiti.git
cd mcp-graphiti
cp .env.example .env   # サンプル環境ファイルをコピー

⚠️ 重要なセキュリティ注意事項

• NEO4J_PASSWORD が 'password' に設定されている場合、GRAPHITI_ENV=dev を明示的に設定しない限り、サービスは起動を拒否します。
• 開発環境以外では、強力なパスワードを使用してください。

2. CLIツールをインストールする

pipx install . --include-deps   # ユーザーに推奨される方法
# または貢献者の場合:
python -m venv .venv && source .venv/bin/activate && pip sync uv.lock && pip install -e .

3. サービスを起動する

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
# ai/graph/entities/ ディレクトリにエンティティYAMLファイルを追加する

📚 プロジェクト設定 (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スタックを1つのトップレベルコマンドで公開します。
• graphiti prune: オーファン group_id グラフのスペースを1クリックで回収します。

PRとIssuesを歓迎します！