Graphrag MCP

🚀 グラフRAG MCP サーバー

混合グラフとベクトルデータベースシステムをクエリするためのモデルコンテキストプロトコル（Model Context Protocol）サーバーです。Neo4j（グラフデータベース）とQdrant（ベクトルデータベース）を組み合わせることで、強力なセマンティック検索とグラフベースのドキュメント検索を実現します。

🚀 クイックスタート

GraphRAG MCPは、大規模言語モデルと混合検索システムをシームレスに統合します。このシステムは、グラフデータベース（Neo4j）とベクトルデータベース（Qdrant）の利点を活用しています。これにより、以下のような機能が可能になります。

• 文章埋め込みを使用したセマンティック検索
• グラフベースの関係を利用したコンテキスト拡張
• ベクトル類似性とグラフ関係を組み合わせた混合検索
• MCPプロトコルを介したClaudeや他の大規模言語モデル（LLM）との完全統合

このプロジェクトはモデルコンテキストプロトコルの仕様に準拠しているため、MCPをサポートするすべてのクライアントと互換性があります。

✨ 主な機能

• セマンティック検索：文章埋め込みとQdrantを使用して行います。
• グラフベースのコンテキスト拡張：Neo4jを使用します。
• 混合検索：上記の2つの方法を組み合わせます。
• MCPツールとリソース：LLMとの統合に使用します。
• Neo4jスキーマとQdrantコレクションの情報を完全に記録します。

📦 インストール

前提条件

• オペレーティングシステム：Linux、macOSまたはWindows（64ビットを推奨）
• Pythonバージョン：3.8以上
• メモリ要件：少なくとも4GBのRAM
• ディスク空間：少なくとも10GBの空き容量
• 依存関係管理ツール：pipenvの使用をおすすめします。

クイックインストール

以下のコマンドを使用してクイックインストールを行います。

git clone https://github.com/rileylemm/graphrag-mcp.git
cd graphrag-mcp
pip install -r requirements.txt

詳細なインストール手順

1. リポジトリをクローンする：

   git clone https://github.com/rileylemm/graphrag-mcp.git
   cd graphrag-mcp
   

2. 依存関係をインストールする：

   pip install -r requirements.txt
   

3. 環境変数を設定する： .envファイルを作成し、以下の内容を追加します。

   NEO4J_URI=あなたのNeo4j接続文字列
   NEO4J_USER=あなたのNeo4jユーザー名
   NEO4J_PASSWORD=あなたのNeo4jパスワード
   QDRANT_HOST=http://localhost:6333
   

4. サーバーを起動する：

   python -m graphrag.mcp.server
   

💻 使用例

MCPクライアントとの統合

サンプルコード

from mcpipy import mcp

# MCPサーバーに接続する
client = mcp.Client("http://localhost:8080")

# クエリの例
response = client.query("クエリ内容", resource="https://graphrag.db/collection/qdrant")
print(response)

使い方

MCPリソース

• https://graphrag.db/schema/neo4j：Neo4jグラフデータベースのスキーマ情報を提供します。
• https://graphrag.db/collection/qdrant：Qdrantベクトルコレクションの情報を提供します。

トラブルシューティング

• 接続問題：Neo4jとQdrantが動作しており、アクセス可能であることを確認してください。
• 空の結果：ドキュメントコレクションが正しくインデックス付けされていることを確認してください。
• 依存関係の欠落：pip install -r requirements.txtを実行して、すべてのパッケージがインストールされていることを確認してください。
• データベース認証：.envファイルの資格情報を確認してください。

🤝 コントリビューションガイド

コントリビューションを歓迎します！自由にプルリクエストを送信してください。

📄 ライセンス

MITライセンス

Copyright (c) 2025 Riley Lemm

以下の条件の下で、誰でも無料でこのソフトウェアおよび関連文書ファイル（「ソフトウェア」）を使用、コピー、変更、結合、公開、配布、サブライセンス、および/または販売することが許可されます。ただし、これには契約、不法行為、またはその他の方法によるソフトウェアの使用権が含まれます。

ソフトウェアは「現状のまま」提供され、商品性、特定の用途への適合性、および非侵害性に関する明示または暗示の保証を含む、いかなる保証も行われません。契約、不法行為、またはその他の方法に起因するいかなる請求、損害、またはその他の責任についても、作者または著作権者は責任を負いません。

🙏 謝辞

このMCPサーバーを使用するか、自分の目的に利用する場合は、必ずRiley Lemmに引用を提供し、このリポジトリ（https://github.com/rileylemm/graphrag_mcp）にリンクを貼ってください。