Graphiti MCP Server

Graphiti MCP サーバー

getzep/graphiti のサンプルをフォークし、開発者エクスペリエンスと複数プロジェクトのサポートに重点を置いています。Graphiti はテキストからエンティティと関係を抽出し、Neo4j に保存します。このリポジトリでは、Docker でルートサーバーとプロジェクト固有の MCP サーバーを起動する CLI を追加しているため、複数のナレッジグラフが同じデータベースを共有できます。

クイックスタート

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 の認証情報を使用して、http://localhost:7474 で Neo4j を閲覧します。

セキュリティに関する注意

NEO4J_PASSWORD が password のままの場合、GRAPHITI_ENV=dev が設定されていない限り、サーバーは起動を拒否します。本番環境では必ず強力なパスワードを使用してください。

このフォークの理由

上流のリポジトリでは、compose ファイルごとにサーバーを 1 つ使うことが前提になっています。ここでは、1 つの compose ファイルで、Neo4j を共有する複数のプロジェクトサーバーを管理します。各サービスには独自の group_id、エンティティ、モデルが割り当てられるため、同じデータベース上で実行してもプロジェクトは分離されます。

主な特長

• プロジェクトの分離 – 異なる抽出ルールやモデルが互いに干渉しません。
• エディターによる自動検出 – ポートは .cursor/mcp.json に書き込まれます。
• クラッシュの封じ込め – プロンプトに問題があっても、再起動するのはそのコンテナだけです。
• ホットリロード – プロジェクトの設定を変更し、graphiti reload <container> を実行します。

ルートサーバーだけが必要な場合は、mcp-projects.yaml を空のままにしてください。

注意が必要な設定

NEO4J_DESTROY_ENTIRE_GRAPH=true を設定すると、次回 graphiti up を実行したときにすべてのプロジェクトが消去されます。使用には十分注意してください。

コントリビューション

PR と Issue を歓迎します。

© 2025 rawr‑ai • MIT License