MCP Neo4j Knowledge Graph

🚀 MCP知識グラフプロジェクトドキュメント

MCP（Medical Cybernetics Platform）知識グラフプロジェクトは、Neo4jグラフデータベースを利用して、医学分野の知識グラフを構築および管理することを目的としています。このプロジェクトは、データのインポート、エンティティ操作、関係管理、スキーマ洞察など、豊富な機能モジュールを提供しています。

🚀 クイックスタート

MCP知識グラフプロジェクトを始めるには、以下の手順に従ってください。

MCPクライアントの起動

サーバーを起動するには、task run コマンドを実行します。

task run

利用可能なツールの確認

/tools インターフェースにアクセスすることで、利用可能なツールの情報を取得できます。

データベーススキーマの詳細取得

/schema インターフェースを呼び出すことで、データベースのスキーマ詳細（ノードラベル、関係タイプ、それらの属性を含む）を取得できます。

✨ 主な機能

1. MCPクライアント機能

• サーバーの起動：task run コマンドを実行してMCPサービスを起動します。
• ツールリスト：/tools インターフェースにアクセスして、利用可能なツールの情報を取得します。
• スキーマ洞察：/schema インターフェースを呼び出して、データベースのスキーマ詳細を取得します。

2. MCP設定管理

• 設定ファイルの読み込み：config.yaml ファイルの正しさを検証します。
• 接続テスト：公式のMCP SDKを使用して、データベースとの接続状態をテストします。
• ツールの可用性チェック：すべての必須ツールがインストールされていることを確認します。

3. Neo4jデータベース接続

• 接続性の検証：基本的なクエリを実行して、データベースにアクセスできるかどうかをテストします。
• 環境設定の確認：実行環境の設定が要件を満たしていることを確認します。

📦 インストール

本プロジェクトでは、以下のコマンドを使用して開発タスクを実行できます。

Taskコマンドを使用する場合

# コードのフォーマット
task format

# コードチェックの実行
task lint

# テストの実行
task test

# 開発環境の起動
task dev

Poetryを使用する場合

# コードのフォーマット
poetry run black .

# インポートの並べ替え
poetry run isort .

# コードチェックの実行
poetry run flake8

# テストの実行
poetry run pytest

💻 使用例

テストスクリプトの実行

MCPクライアントのテスト

task test-client  # クライアントのテストのみを実行

MCP設定のテスト

task test-config  # 設定のテストのみを実行

Neo4j接続のテスト

task test-db  # データベースのテストのみを実行

すべてのテストの実行

task test  # pytestと統合テストを含むすべてのテストを実行

🔧 技術詳細

核心コンポーネント

1. MCPクライアント：Neo4jデータベースとのやり取りに使用されます。
2. 設定ツール：設定ファイルの読み込みと検証を担当します。
3. Neo4j接続テスト：データベースの接続性と基本的なクエリ機能を確認します。
4. 統合テスト：システム全体の完全性と互換性を検証します。

エラー処理

サーバーは、以下のシナリオを含む包括的なエラー処理メカニズムを実装しています。

• データベース接続の問題
• 無効なクエリ
• ノードの欠落
• リクエスト形式のエラー
• スキーマ検証の失敗
• 関係の作成異常
• エンティティの更新衝突

すべてのエラーは、MCPプロトコルに準拠したエラーメッセージを返します。

📚 ドキュメント

Docker設定

Neo4jコンテナの設定は以下の通りです。

• ポート：7474（HTTP）と7687（Bolt）
• デフォルトの資格情報：neo4j/password
• APOCプラグインの有効化
• ファイルのインポートとエクスポートの許可
• ヘルスチェックの設定

これらの設定は、docker-compose.yml ファイルで変更できます。

Taskコマンドリファレンス

# サービスの起動
task run

# テストの実行
task test

# コードのフォーマット
task format

# チェックの実行
task lint

# 開発環境の起動
task dev