MCP Experts

🚀 MCPコードエキスパートシステム

このシステムはPythonベースのコードレビューシステムで、モデルコンテキストプロトコル（MCP）を使用しています。Martin FowlerやRobert C. Martin（Uncle Bob）などのエキスパートの役割を模擬して、コードレビュー機能を提供します。

🚀 クイックスタート

このコードレビューシステムを使う前に、いくつかの前提条件を満たす必要があります。また、インストール、設定、使用方法についても説明します。

✨ 主な機能

• Martin Fowlerのリファクタリング原則に基づくコードレビュー
• Robert C. MartinのClean Code原則に基づくコードレビュー
• コード、コメント、およびそれらの関連性を知識グラフに保存
• Ollamaとの統合によるAI駆動のレビュー
• Web統合のためのサーバーサイドイベント（SSE）のサポート

📦 インストール

前提条件

Python 3.10+

このプロジェクトではPython 3.10以上が必要です。

Ollama

Ollama はAI駆動のコードレビューに使用されます。

1. プラットフォームに合わせてOllamaをインストールします：
   • macOS：ollama.com からダウンロードします。
   • Linux：curl -fsSL https://ollama.com/install.sh | sh を実行します。
   • Windows：WSL2でサポートされるLinuxコマンドを使用します。
2. 推奨モデルを取得します：

   ollama pull llama3:8b
   

3. Ollamaサーバーを起動します：

   ollama serve
   

依存関係のインストール

依存関係をインストールし、仮想環境を作成するには、インストールスクリプトを実行します：

chmod +x setup.sh
./setup.sh

🔧 設定

.env ファイルを編集して設定を行います（必要に応じて .env.example から作成します）：

# 知識グラフの設定
KNOWLEDGE_GRAPH_PATH=data/knowledge_graph.json

# Ollamaの設定（ローカルAIモデル）
OLLAMA_HOST=http://localhost:11434
OLLAMA_MODEL=llama3:8b

💻 使用例

サーバーの起動

標準モード（Cursor統合用）

source .venv/bin/activate
python server.py

HTTP/SSEモード（Web統合用）

source .venv/bin/activate
python server.py --transport sse

これにより、http://localhost:8000/sse でSSEトランスポートのサーバーが起動します。

ポートをカスタマイズするには：

python server.py --transport sse --port 9000

Cursorへのインストール

Cursor IDEにインストールするには：

source .venv/bin/activate
mcp install server.py --name "Code Expert System"

利用可能なツール

サーバーは以下のツールを公開しています：

• ask_martin：Martin Fowlerにコードをレビューし、リファクタリングの提案を求めます。
• ask_bob：Robert C. Martin（Uncle Bob）にClean Code原則に基づいてコードをレビューしてもらいます。
• read_graph：知識グラフ全体を読み取ります。
• search_nodes：知識グラフ内でノードを検索します。
• open_nodes：名前で特定のノードを開きます。

基本的な使用法

Martin Fowlerにコードスニペットをレビューしてもらう例：

{
  "code": "function calculateTotal(items) {\n  var total = 0;\n  for (var i = 0; i < items.length; i++) {\n    total += items[i].price;\n  }\n  return total;\n}",
  "language": "javascript"
}

📚 ドキュメント

プロジェクト構造

• server.py：メインサーバーファイル
• config.py：設定ファイル
• knowledge_graph.py：知識グラフ機能
• models/：AIモデルインターフェース
• templates/：Webインターフェーステンプレート

アーキテクチャ

システムは以下のモジュールで構成されています：

• サーバー：リクエストを処理し、各コンポーネントを調整します。
• 知識グラフ：コードとその関連性を保存および管理します。
• Ollama統合：AIサービスとのやり取りを行い、インテリジェントなレビューを提供します。
• Webインターフェース：ユーザーフレンドリーなコードレビューインターフェースを提供します。

📄 ライセンス

このプロジェクトは MIT License の下で公開されています。