Skip to main content
Glama

mutual-review-mcp

PyPI version License: MIT Python: 3.10+ MCP

📖 解説記事 (日本語): 自作MCPサーバーを書いて公開するまで

Claude × GPT-4o 相互コードレビュー MCP サーバー

2つの LLM がそれぞれ独立にコードをレビューし、Claude が両方の指摘を統合した最終レポートを返す MCP (Model Context Protocol) サーバーです。

30秒で読める要約

  • Claude Desktop / Claude Code / 任意の MCP クライアントから呼べる

  • review_file / review_code / review_diff の 3 ツール

  • 拡張子から言語自動推定 (.py → python, .ts → typescript, ...)

  • API キーは環境変数で渡す

  • コスト追跡はオプション (ENABLE_COST_TRACKING=1 で有効化)

Related MCP server: Claude Code Review MCP

クイックスタート (Claude Code)

claude mcp add mutual-review -- uvx mutual-review-mcp

事前に ANTHROPIC_API_KEY と OPENAI_API_KEY を環境変数に設定してください。

インストール

pip install mutual-review-mcp
# または、インストールせず一時実行:
uvx mutual-review-mcp

詳細

A. uvx (推奨・一時実行)

uvx mutual-review-mcp              # MCPサーバー起動 (stdio)
uvx --from mutual-review-mcp mutual-review path/to/foo.py  # CLI

B. pip

pip install mutual-review-mcp
mutual-review-mcp                  # MCP サーバー起動
mutual-review path/to/foo.py       # 単発 CLI

C. git clone (開発用)

git clone https://github.com/miharu8686/mutual-review-mcp
cd mutual-review-mcp
pip install -e .[dev]
pytest

Claude Desktop 設定

%APPDATA%/Claude/claude_desktop_config.json (macOS は ~/Library/Application Support/Claude/claude_desktop_config.json) に:

{
  "mcpServers": {
    "mutual-review": {
      "command": "uvx",
      "args": ["mutual-review-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-...",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

完全な例は examples/claude_desktop_config.json を参照。

Claude Code 設定

claude mcp add mutual-review -- uvx mutual-review-mcp

または .mcp.json を手書き:

{
  "mcpServers": {
    "mutual-review": {
      "command": "uvx",
      "args": ["mutual-review-mcp"]
    }
  }
}

ツール一覧

review_file

ファイルをディスクから読んで両モデルでレビュー。

引数

型

必須

説明

path

string

yes

レビュー対象ファイルの絶対パス

language

string

no

言語ヒント。省略時は拡張子から自動推定

context

string

no

コードの背景情報

synthesize

boolean

no

統合レポート生成 (default: true)

呼び出し例:

review_file(path="/repo/src/auth.py", context="OAuth2 callback handler")

review_code

コードスニペットを直接渡してレビュー。

引数

型

必須

説明

code

string

yes

レビュー対象コード

language

string

no

言語ヒント

filename

string

no

文脈用ファイル名

context

string

no

背景情報

synthesize

boolean

no

統合レポート生成 (default: true)

review_diff

unified diff 文字列を直接渡してレビュー。v0.1 では git 実行は行わない。 呼び出し側で git diff の出力を取得して渡す:

git diff HEAD~1 | mutual-review --diff -

引数

型

必須

説明

diff

string

yes

unified diff テキスト

context

string

no

背景情報

synthesize

boolean

no

統合レポート生成 (default: true)

v0.2 で review_diff_git(repo_path, ref) を追加予定。詳細は docs/ROADMAP.md。

CLI

MCP を経由せず直接実行する CLI も同梱:

# ファイルレビュー (拡張子から言語自動推定)
mutual-review path/to/foo.py

# スニペット
mutual-review --code "def foo(): pass" --language python

# 標準入力から diff
git diff HEAD~1 | mutual-review --diff -

# 統合レポートを省略
mutual-review path/to/foo.py --no-synth

動作のしくみ

              [ Code / File / Diff ]
                       |
            +----------+----------+
            |                     |
            v                     v
   +-----------------+   +-----------------+
   | Claude reviewer |   |  GPT reviewer   |   (並列実行)
   +-----------------+   +-----------------+
            |                     |
            +----------+----------+
                       |
                       v
              +------------------+
              | Claude synthesizer|   (両レビューを統合)
              +------------------+
                       |
                       v
                 [ Final Report ]

統合レポートには以下が含まれます:

  1. 両モデルが合意した指摘 (高優先度)

  2. 各モデル固有の発見

  3. 優先順位付きアクションアイテム

  4. 総合判定 (Ready / Needs Minor Work / Needs Major Work)

コスト目安

multi_agent.py (520 行・約 7,000 文字) を 1 ファイルレビュー (統合あり) した実測値:

モデル構成

合計トークン (in/out)

1ファイルあたり

claude-haiku-4-5 + gpt-4o-mini

16,130 / 4,489

約 $0.025 (約 ¥4)

claude-sonnet-4-6 + gpt-4o

16,161 / 4,204

約 $0.105 (約 ¥16)

1 USD = 155 円換算・2026-05 時点。価格は reviewer.py の PRICING で管理しています。

--no-synth で 3 回中 1 回 (統合呼び出し) を省略でき、Sonnet/gpt-4o 構成で約 30% コスト削減できます。

モデル変更は環境変数で:

MUTUAL_REVIEW_CLAUDE_MODEL=claude-haiku-4-5-20251001
MUTUAL_REVIEW_GPT_MODEL=gpt-4o-mini

環境変数一覧

変数

デフォルト

説明

ANTHROPIC_API_KEY

—

(必須) Anthropic API キー

OPENAI_API_KEY

—

(必須) OpenAI API キー

MUTUAL_REVIEW_CLAUDE_MODEL

claude-sonnet-4-6

Claude モデル名

MUTUAL_REVIEW_GPT_MODEL

gpt-4o

GPT モデル名

ENABLE_COST_TRACKING

0

1/true でコスト追跡ログ出力

COST_LOG_PATH

OS依存 (XDG 準拠)

コストログの出力先 (usage.jsonl)

MUTUAL_REVIEW_CONFIG

OS依存

JSON 設定ファイルパス (APIキーフォールバック)

設定ファイル (オプション)

環境変数の代わりに JSON 設定ファイルから API キーを読むこともできます。

デフォルトパス:

  • Windows: %APPDATA%\mutual-review-mcp\config.json

  • macOS: ~/Library/Application Support/mutual-review-mcp/config.json

  • Linux: ~/.config/mutual-review-mcp/config.json

内容:

{
  "anthropic_api_key": "sk-ant-...",
  "openai_api_key": "sk-..."
}

エラーメッセージ

エラーメッセージは日英併記です:

ANTHROPIC_API_KEY が設定されていません / ANTHROPIC_API_KEY is not set. ...
Anthropic API への接続に失敗しました: ... / Failed to call Anthropic API: ...

ライセンス

MIT

関連

Available Tools

3 tools
review_codeA

Mutual code review on a code snippet. Claude and GPT-4o each review independently, then Claude synthesizes.

Inputs: code (required), context, filename, language, +1 more.

review_diffB

Mutual code review on a unified diff string. Pass the diff text directly (no git invocation is performed).

Inputs: diff (required), context, synthesize.

review_fileA

Mutual code review on a file. Claude and GPT-4o each review independently, then Claude synthesizes the findings.

Inputs: path (required), context, language, synthesize.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a distinct input type (code snippet, diff string, file), with clear descriptions that prevent any ambiguity.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern using 'review_' prefix followed by the input type, making them predictable and easy to understand.

    Tool Count5/5

    Three tools is perfectly scoped for a focused code review server, covering the essential input types without unnecessary bloat.

    Completeness5/5

    The tool set covers all common code review scenarios (snippet, diff, file), providing complete lifecycle coverage for the stated purpose.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      An MCP server that connects Gemini 2.5 Pro to Claude Code, enabling users to generate detailed implementation plans based on their codebase and receive feedback on code changes.
      5
      14
      -
    • A
      license
      A
      quality
      C
      maintenance
      A multi-model AI orchestration MCP server for automated code review and LLM-powered analysis, integrating with Claude Code and OpenCode to orchestrate multiple AI models for code quality checks, security analysis, and multi-agent consensus.
      6
      36
      MIT