Code Review Analyst MCP

🚀 Code Lens MCP Server

Google Geminiを利用した自動コードレビュー、分析、およびドキュメント生成のためのMCPサーバーです。

🚀 クイックスタート

必要条件

• Node.js >= 24
• Gemini APIキー (GEMINI_API_KEY または GOOGLE_API_KEY)

設定例

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

Dockerを使用する場合

docker run -i --rm -e GEMINI_API_KEY="your-api-key" ghcr.io/j0hanz/code-lens

または、Docker Composeを使用する場合:

GEMINI_API_KEY=your-api-key docker compose up

✨ 主な機能

• PRレビューパイプライン — 差分を生成し、影響を評価し、破壊的なAPI変更を検出し、マージ推奨事項付きのレビュー要約を生成します。
• ファイル分析 — 任意のソースファイルを読み込んで、リファクタリングの提案、コードの悪臭検出、ドキュメント生成、および自然言語での質問応答を行います。
• ロジック検証 — Geminiのコード実行サンドボックスを使用してアルゴリズムを検証します。
• 構造化出力 — すべてのツールは、Zod v4出力スキーマを介して検証済みのJSONを返します。
• ウェブ検索 — Google Search with Groundingを使用して最新の情報を取得します。
• タスクライフサイクルサポート — load_file を除くすべてのツールは、ポーリング、キャンセル、および進捗更新を伴うMCPタスクで実行できます。

📦 インストール

各クライアントでのインストール方法

VS Code

{
  "servers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

または、CLIを介してインストールする場合:

code --add-mcp '{"name":"code-lens","command":"npx","args":["-y","@j0hanz/code-lens-mcp@latest"]}'

詳細については、VS Code MCPドキュメント を参照してください。

VS Code Insiders

{
  "servers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

または、CLIを介してインストールする場合:

code-insiders --add-mcp '{"name":"code-lens","command":"npx","args":["-y","@j0hanz/code-lens-mcp@latest"]}'

詳細については、VS Code Insiders MCPドキュメント を参照してください。

Cursor

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

詳細については、Cursor MCPドキュメント を参照してください。

その他のクライアント

他のクライアント（Visual Studio、Goose、LM Studioなど）のインストール方法もREADMEに記載されています。詳細は各クライアントのMCPドキュメントを参照してください。

💻 使用例

PRレビューパイプライン

1. generate_diff を呼び出して、未ステージまたはステージされた変更をキャプチャします。
2. analyze_pr_impact を実行して、影響の重大度と破壊的な変更を評価します。
3. generate_review_summary を実行して、リスク評価とマージ推奨事項を生成します。
4. detect_api_breaking_changes を実行して、公開APIの破壊的な変更をチェックします。
5. generate_test_plan を実行して、優先順位付けされたテストケースを生成します。

単一ファイル分析

1. load_file を呼び出して、ソースファイルをキャッシュします。
2. refactor_code を実行して、構造的な改善提案を取得します。
3. detect_code_smells を実行して、Fowler分類法に基づくコードの悪臭を検出します。
4. generate_documentation を実行して、JSDoc/TSDocスタブを生成します。
5. ask_about_code を使用して、キャッシュされたファイルに関する自然言語の質問応答を行います。
6. verify_logic を使用して、コード実行によりアルゴリズムを検証します。

パフォーマンス監査

1. パフォーマンスに敏感な変更に対して generate_diff を呼び出します。
2. analyze_time_space_complexity を実行して、Big-Oの劣化を検出します。

調査

• web_search を使用して、Google Search with Groundingを介して最新のドキュメントまたはAPIリファレンスを取得します。

📚 ドキュメント

アーキテクチャ

[MCP Client]
    │
    │ Transport: stdio
    ▼
[MCP Server: code-lens]
    │ Entry: src/index.ts → src/server.ts
    │
    ├── initialize / initialized (lifecycle handshake)
    │
    ├── tools/call ──────────────────────────────────────────────
    │   │
    │   │ Diff-based tools (require generate_diff first):
    │   ├── [generate_diff]              Sync — capture git diff
    │   ├── [analyze_pr_impact]          Flash — severity & impact
    │   ├── [generate_review_summary]    Flash — risk & merge rec
    │   ├── [generate_test_plan]         Flash — test cases
    │   ├── [analyze_time_space_complexity] Flash — Big-O analysis
    │   ├── [detect_api_breaking_changes]  Flash — API breakage
    │   │
    │   │ File-based tools (require load_file first):
    │   ├── [load_file]                  Sync — cache source file
    │   ├── [refactor_code]              Flash — refactoring
    │   ├── [detect_code_smells]         Flash — smell detection
    │   ├── [generate_documentation]     Flash — doc stubs
    │   ├── [ask_about_code]             Flash — Q&A
    │   ├── [verify_logic]               Flash — code execution
    │   │
    │   │ Standalone:
    │   └── [web_search]                 Flash — Google Search
    │
    ├── resources/read ──────────────────────────────────────────
    │   ├── [internal://instructions]        Server usage guide
    │   ├── [internal://tool-catalog]        Tool reference
    │   ├── [internal://workflows]           Workflow sequences
    │   ├── [internal://server-config]       Runtime config
    │   ├── [internal://tool-info/{name}]    Per-tool details
    │   ├── [internal://diff/current]        Cached diff (text/x-patch)
    │   └── [internal://file/current]        Cached source file
    │
    ├── prompts/get ─────────────────────────────────────────────
    │   ├── [get-help]           Full server instructions
    │   ├── [review-guide]       Tool + focus area workflow
    │   ├── [select-workflow]    Pipeline by change type
    │   ├── [analyze-file]       File analysis pipeline
    │   └── [tool-chain]         Tool prerequisite chain
    │
    └── Capabilities: structured output, tool annotations, notifications

リクエストライフサイクル

[Client] -- initialize {protocolVersion, capabilities} --> [Server]
[Server] -- {protocolVersion, capabilities, serverInfo} --> [Client]
[Client] -- notifications/initialized --> [Server]
[Client] -- tools/call {name, arguments} --> [Server]
[Server] -- notifications/progress {token, progress, total} --> [Client]
[Server] -- {content, structuredContent, isError?} --> [Client]

タスクライフサイクル

• generate_diff と load_file は同期のみです。その他のすべてのツールは taskSupport: optional を宣言しています。
• リクエスターはタスクTTLを指定できます。サーバーはその値を最大 MAX_TASK_TTL_MS まで使用し、指定されない場合は TASK_TTL_MS にフォールバックします。
• キャンセルされたタスクは cancelled として終了し、tasks/result はキャンセル形状のツール結果を返します。

MCPサーフェス

ツール

リソース

プロンプト

MCP機能

ツールアノテーション

すべてのツールはMCPツールアノテーションを公開します。

構造化出力

すべてのGeminiベースのツールは、Zod v4出力スキーマを使用して、テキスト content とともに検証済みの structuredContent を返します。

設定

CLIフラグ

npx @j0hanz/code-lens-mcp@latest --model gemini-2.5-flash --max-diff-chars 200000

🔧 技術詳細

セキュリティ

開発

npm install          # 依存関係のインストール
npm run build        # TypeScriptのコンパイル
npm run dev          # ウォッチモード
npm run dev:run      # --watchと.envで実行
npm run start        # コンパイルされたサーバーの実行
npm run type-check   # ソースコードとテストの型チェック
npm run lint         # ESLint
npm run test         # テストスイートの実行
npm run format       # Prettier
npm run inspector    # MCPインスペクター
npm run knip         # 未使用コードの検出

ビルドとリリース

• CI: .github/workflows/release.yml
• Docker: node:24-alpine を使用したマルチステージビルド (Dockerfile)
• Docker Compose: docker-compose.yml
• npm: @j0hanz/code-lens-mcp として公開されています。

トラブルシューティング

• APIキーが不足している場合: 環境変数またはクライアント設定の env ブロックで GEMINI_API_KEY または GOOGLE_API_KEY を設定してください。
• "E_NO_DIFF" エラーが発生した場合: 差分ベースのレビューツールを実行する前に generate_diff を呼び出してください。
• "E_NO_FILE" エラーが発生した場合: ファイル分析ツールを実行する前に load_file を呼び出してください。
• 大きな差分が切り捨てられた場合: MAX_DIFF_CHARS を増やしてください（デフォルト: 120,000文字）。
• Stdoutにノイズがある場合: 他のプロセスがstdoutに書き込まないようにしてください。サーバーはstdioトランスポートを使用しています。

クレジット

• Google Gemini — LLMバックエンド (@google/genai)
• Model Context Protocol SDK — MCPフレームワーク (@modelcontextprotocol/sdk)
• Zod — スキーマ検証 (zod v4)
• parse-diff — 差分解析

📄 ライセンス

MITライセンス。詳細は LICENSE を参照してください。

プルリクエスト を通じた貢献を歓迎します。