MCP Graphiti

🚀 グラフィティ（Graphiti）プロジェクト紹介

Graphiti は、Docker と GraphQL をベースにした知識グラフ構築ツールです。ドキュメントやコードコメントなど様々なソースから情報を簡単に抽出し、意味ネットワークを構築することができます。このプロジェクトは開発者向けに設計されており、知識グラフの迅速な構築と管理を支援します。

🚀 クイックスタート

1. プロジェクトのクローンと環境の設定

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

⚠️ 重要な注意事項

• NEO4J_PASSWORD がデフォルト値 'password' に設定されている場合、GRAPHITI_ENV=dev または GRAPHITI_ENV=development を明示的に設定しない限り、プログラムは起動を拒否します。
• 開発環境以外では、必ず NEO4J_PASSWORD に強力なパスワードを設定してください。

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.yml ファイルの生成
graphiti up -d     # サービスをバックグラウンドで起動

4. プロジェクトの作成

cd ~/code
graphiti init acme-support-bot   # 新しいプロジェクトのルートディレクトリでこのコマンドを実行
cd acme-support-bot
# エンティティ YAML ファイルを ai/graph/entities/ ディレクトリに追加

✨ 主な機能

Graphiti は以下の主要機能を提供します：

1. 知識グラフの構築：複数のソースから情報を抽出し、自動的に意味ネットワークを構築します。
2. GraphQL クエリのサポート：GraphQL インターフェースを通じて知識グラフデータをクエリおよび検索します。
3. 拡張可能なプラグインシステム：カスタムプラグインをサポートし、機能の拡張を容易にします。
4. 可視化インターフェース：知識グラフの表示と管理に直感的なグラフィカルインターフェースを提供します。

📚 ドキュメント

プロジェクト構成 (mcp-projects.yaml)

mcp-projects.yaml ファイルは、複数のプロジェクトの構成を定義および管理するために使用され、以下の内容を含みます：

1. プロジェクトリスト：構築するすべての知識グラフをリストします。
2. データソース構成：各プロジェクトのドキュメント、コードコメントなどのソースを指定します。
3. プラグイン拡張：カスタムプラグインの使用方法を定義します。

よくある質問

Q: 機能を拡張するにはどうすればいいですか？

A: カスタムプラグインを作成し、それを mcp-projects.yaml に追加することで機能を拡張できます。

Q: パフォーマンスを最適化するにはどうすればいいですか？

A: 以下の方法で最適化できます：

1. 適切なキャッシュポリシーを設定する。
2. 効率的なストレージバックエンド（例：Redis）を使用する。
3. データ抽出タスクを並列処理する。

安全上の注意

• すべての機密情報（API キー、データベースの資格情報など）がコード内に平文で保存されていないことを確認してください。
• 知識グラフデータを定期的にバックアップし、予期しないデータ損失を防いでください。

危険区域

• 実験的な機能：一部の新機能は十分にテストされていない可能性があります。使用する前にリスクを慎重に評価してください。
• データクリーニング：データクリーニング操作を実行する前に、重要なデータをバックアップしてください。

将来の開発計画

1. プラグインシステムの強化：より多くの組み込みプラグインを提供し、より柔軟な拡張方法をサポートします。
2. パフォーマンスの最適化：大規模な知識グラフの構築とクエリ効率を向上させます。
3. ドキュメントの充実：より詳細な使用ガイドと技術ドキュメントを提供し、学習の敷居を下げます。

詳細な情報については、プロジェクトの公式サイトを訪問するか、関連する技術ドキュメントを参照してください。