Ndlovu Code Reviewer

🚀 コードレビューMCPサーバー

Gemini-CLI（現時点では）をベースにしたコードレビューアシスタントで、Model Context Protocol (MCP) サーバーとして動作します。

🚀 クイックスタート

このコードレビューMCPサーバーは、Gemini-CLIを利用し、MCPサーバーとして機能するコードレビューアシスタントです。これを使用することで、手動のコードレビューの負担を軽減し、静的解析とコンテキストに基づいた人間にやさしいフィードバックを得ることができます。

✨ 主な機能

• Gemini-CLIを使用したコードレビューアシスタントを提供します。
• Model Context Protocol (MCP) サーバーとして動作し、MCP互換のクライアントと通信可能です。
• ローカルの未コミット変更から差分とリント結果を自動的に収集します。
• 収集したコンテキストをGemini CLIにストリーミングし、アクション可能な洞察を得ます。
• 構造化されたJSON形式のレビュー結果を返します。

📦 インストール

必要条件

• Node.js 18以降（ESモジュールとAbortSignalsが使用されています）
• npm（Node.jsと一緒にインストールされます）
• Git（ローカルの差分を収集するために使用されます）
• Google Gemini CLI (gemini) がインストールされ、認証されていること。詳細なセットアップ手順は the Gemini quickstart を参照してください。

インストール手順

git clone https://github.com/<your-org>/ndlovu-code-reviewer.git
cd ndlovu-code-reviewer
npm install
npm run build

TypeScriptソースを繰り返し開発する場合は、npm run build をスキップし、以下で説明する開発用スクリプトを使用できます。

💻 使用例

基本的な使用法

MCPサーバーの起動

npm start

サーバーは標準入出力を介して通信するため、MCP互換のクライアント（IDE統合やアシスタントサンドボックスなど）に登録することができます。接続後、review-local-changes ツールを呼び出すと、ハイブリッド分析が実行され、JSON形式のレビュー結果が返されます。

review-local-changes ツールの使用方法

このツールは、ローカルの未コミットコードの変更を包括的に分析します。

前提条件:

• Gitリポジトリに未コミットの変更があること。
• 変更されたファイルはJavaScript、TypeScript、またはVueファイル（.js, .ts, .tsx, .vue）であること。
• Gemini CLIがインストールされ、認証されていること。

ツールの動作:

1. 自動的な変更検出 - git diff を使用して、すべての変更/追加されたJS/TS/Vueファイルを検出します。
2. 静的解析の実行 - 利用可能な最適なリンター（ESLint、JSHint、またはTypeScriptコンパイラ）を実行します。
3. AIレビューの実行 - 収集したコンテキストをGemini CLIに送信し、インテリジェントな分析を行います。
4. 構造化された結果の返却 - 検出結果と推奨事項を含むJSON形式のレスポンスを提供します。

Claude Codeでの使用方法: 最適な結果を得るには、コードレビュー機能の使用を明示的に指定してください。自然言語によるリクエストも時々機能しますが、最も信頼性の高いアプローチは、特定のキーワードを使用することです。

最も信頼性の高いリクエスト（推奨）:

• "Use the code review tool to analyze my changes"
• "Run code review on my local changes"
• "Perform a comprehensive code review of my uncommitted changes"
• "Analyze my code changes with static analysis"

自然言語によるリクエスト（動作する場合がありますが、信頼性が低い）:

• "Please review my local changes"
• "Can you analyze the code changes I've made?"

明示的なツール呼び出し（最も信頼性が高い）:

• "Use the review-local-changes tool"
• "Call the review-local-changes tool to check my modifications"

このツールは、Claudeが使用するタイミングを認識しやすくするために、より良い説明が追加されていますが、「コードレビュー」、「変更の分析」、またはツール名を直接指定することで、最も一貫した結果が得られます。

出力形式の例:

{
  "summary": "Overview of changes made",
  "assessment": "Overall code quality evaluation",
  "findings": [
    {
      "filePath": "src/example.js",
      "lineNumber": 42,
      "severity": "warning",
      "category": "style",
      "comment": "Detailed explanation of the issue",
      "suggestion": "Specific recommendation for improvement"
    }
  ]
}

注: 関連するファイルが変更されていない場合、ツールは "No relevant files changed" メッセージを返します。これは正常な動作です。

高度な使用法

ローカル開発

• npm run dev – ts-node を使用してサーバーを起動し、迅速な反復開発を行います。
• npm run build – dist/ ディレクトリにコンパイルされたJavaScript出力を生成します。

このプロジェクトの構造は意図的にシンプルになっています。

• src/ – MCPサーバーのTypeScriptソースコード。
• dist/ – npm run build によって生成されたコンパイル済みJavaScript。
• assets/ – 静的アセット、上で使用されているロゴを含みます。

📚 ドキュメント

MCPクライアントからの接続

サーバーをクライアントに接続する前に、npm run build を実行して dist/index.js が存在することを確認してください。以下のコマンドは、クライアントをリポジトリのルートから実行することを前提としています。

Claude Code (VS Code拡張機能)

1. VS Codeでコマンドパレット（Cmd/Ctrl+Shift+P）を開き、Claude: Edit Config File を実行します。
2. mcpServers セクションを見つけ（必要に応じて作成）、以下のようなエントリを追加します。

   {
     "mcpServers": {
       "ndlovu-code-reviewer": {
         "command": "node",
         "args": ["/absolute/path/to/ndlovu-code-reviewer/dist/index.js"],
         "cwd": "/absolute/path/to/ndlovu-code-reviewer"
       }
     }
   }
   

3. ファイルを保存し、Claude: Restart Claude Code を実行するか（またはVS Codeを再読み込み）、サーバーが ツール の下に表示されるようにします。
4. 会話でツールを有効にすると、Claude Codeは review-local-changes の結果をサイドバーに直接ストリーミングします。

Gemini CLI

1. プロジェクトのルートから以下のコマンドを実行します。

   gemini mcp add ndlovu-code-reviewer node $(pwd)/dist/index.js
   

2. gemini mcp list で登録を確認します。
3. 同じリポジトリディレクトリから gemini を起動し、review-local-changes ツールを使用します（例えば、CLIで :tools を実行して選択）。CLIはサーバーを起動し、標準出力をレビューJSONとして返します。

Roo Code

1. Roo Codeを開き、Rooパネルの上部にあるサーバーアイコンをクリックします。
2. Add MCP Server → STDIO を選択し、以下を入力します。
   • Name: ndlovu-code-reviewer
   • Command: node
   • Arguments: /absolute/path/to/ndlovu-code-reviewer/dist/index.js
   • Working Directory: /absolute/path/to/ndlovu-code-reviewer
3. 設定を保存し、ワークスペースでサーバーを有効にします。Rooはこれをグローバルの mcp_settings.json またはプロジェクトの .roo/mcp.json ファイルに保存します。
4. チームメイトと共有するには、以下のような好みの起動コマンドを含む .roo/mcp.json をコミットします。

   {
     "mcpServers": {
       "ndlovu-code-reviewer": {
         "command": "npm",
         "args": ["run", "start"],
         "cwd": "."
       }
     }
   }
   

   Rooは作業ディレクトリをプロジェクトルートに対して解決するため、npm run start スクリプトはリポジトリ自身のパッケージスクリプトをベースに動作します。

Codex CLI

1. サーバーを一度登録します。

   codex mcp add ndlovu-code-reviewer node $(pwd)/dist/index.js
   

2. codex mcp list でエントリを確認した後、リポジトリのルートからCodexを起動します。CLIは review-local-changes をインタラクティブ実行中に呼び出せるツールとして公開します。

🤝 コントリビューション

コントリビューションは大歓迎です。新しいツール、より良いリンター、または改善されたプロンプトに関するアイデアがある場合は、以下の手順に従ってください。

1. アイデアの範囲について合意できるように、イシューまたはディスカッションを開きます。
2. リポジトリをフォークし、機能ブランチを作成します。
3. 将来のコントリビューターの助けになるように、ドキュメント/テストを追加または更新します。
4. 変更内容と検証方法を説明したプルリクエストを送信します。

何から始めればいいかわからない場合は、遠慮なく連絡してください。レビューアの機能を拡張し、クライアントの例を追加し、プロンプトを改善する余地はたくさんあります。

📄 ライセンス

このプロジェクトはISCライセンスの下でライセンスされています。詳細は LICENSE （存在する場合）を参照してください。