MCP Code Expert System

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

モデルコンテキストプロトコル（MCP）を使用したPythonベースのコードレビューシステム。Martin FowlerやRobert C. Martin（Uncle Bob）といった専門家のペルソナをシミュレートすることで、コードレビュー機能を提供します。

特徴

• マーティン・ファウラーのリファクタリング原則に基づいたコードレビュー
• Robert C. Martinのクリーンコード原則に基づいたコードレビュー
• コード、レビュー、関係性のナレッジグラフストレージ
• Ollamaとの統合によるAIを活用したレビュー
• Web統合のためのサーバー側イベント（SSE）のサポート

前提条件

Python 3.10以上

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

オラマ

AI を活用したコードレビューにはOllamaが必要です。

1. お使いのプラットフォームに Ollama をインストールします。
   • macOS : ollama.comからダウンロード
   • Linux : curl -fsSL https://ollama.com/install.sh | sh
   • Windows : Linux の指示による Windows WSL2 サポート
2. 推奨モデルを取得します:
   ollama pull llama3:8b
3. Ollama サーバーを起動します。
   ollama serve

インストール

セットアップ スクリプトを実行して依存関係をインストールし、仮想環境を作成します。

構成

.envファイルを編集して設定します (必要に応じて.env.exampleから作成します)。

使用法

サーバーの実行

標準モード（カーソル統合用）

HTTP/SSE モード (Web 統合用)

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

カスタム ポートの場合:

カーソルへのインストール

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

利用可能なツール

サーバーは次のツールを公開します:

• ask_martin : Martin Fowler にコードのレビューとリファクタリングの提案を依頼する
• ask_bob : Robert C. Martin (Uncle Bob) にクリーンコードの原則に基づいてコードのレビューを依頼する
• read_graph : ナレッジグラフ全体を読み取る
• search_nodes : ナレッジグラフ内のノードを検索する
• open_nodes : 特定のノードを名前で開く

使用例

Martin Fowler と一緒にコード スニペットをレビューするには:

プロジェクト構造

• server.py : MCP 統合によるメインサーバーの実装
• experts/ : コードレビュー機能を実装するエキスパートモジュール
  • __init__.py : 共有モデルとインターフェース
  • martin_fowler/ : Martin Fowler エキスパート実装
  • robert_c_martin/ : Robert C. Martin 専門家による実装
• knowledge_graph.py : コードとレビューを保存するためのナレッジグラフ
• ollama_service.py : AIを活用したレビューのためのOllamaとの統合
• examples/ : さまざまな言語でのレビュー用サンプルコード
• requirements.txt : Python の依存関係
• setup.sh : セットアップスクリプト

建築

システムはモジュラーアーキテクチャに従います。

1. サーバー層: MCPプロトコル通信を処理し、リクエストをルーティングします
2. エキスパートレイヤー: 各エキスパートのコードレビューロジックをカプセル化します
3. サービス層: AI統合とナレッジグラフ機能を提供する

各エキスパートは標準インターフェースを実装しており、一貫した処理と新しいエキスパートの簡単な追加が可能です。

ライセンス

マサチューセッツ工科大学