CodeView MCP 🪄

codeview

codeview は、GitHub のプルリクエスト、ローカルの未コミットの作業、または任意の差分のコード変更をレビューします。 MCP サーバーとして（エディターのアシスタントから呼び出せます）、コマンドラインツールとして、また GitHub Action として動作します。

各レビューは次の 2 つの部分で構成されます。

1. 追加された行に対して実行する、約 50 個の正規表現ルールです。コミットされたシークレット、文字列フォーマットで構築された SQL、eval、shell=True、TLS 検証の無効化、リスクの高い GitHub Actions ワークフローなどを検出します。
2. ロジックのバグ、エッジケース、テストの不足を探すオプションの AI パスです。無料枠のあるプロバイダー（Gemini、Groq、Cerebras、OpenRouter）か、Ollama 経由のローカルモデルのみを使用するため、実行に費用はかかりません。

出力は、ファイルと行にひも付いた指摘事項、判定、およびその理由を示す 0～100 のリスクスコアです。

インストール

Python 3.11 以降が必要です。

pip install git+https://github.com/mann-uofg/codeview-mcp

または、uv を使ってインストールせずに実行できます。

uvx --from git+https://github.com/mann-uofg/codeview-mcp codeview review

使い方

codeview review https://github.com/psf/requests/pull/6883   # a pull request
codeview review owner/repo#123                              # short form
codeview review                                             # uncommitted changes in the current repo
codeview review --staged                                    # only staged changes
codeview review --branch --base main                        # current branch vs main
git diff HEAD~3 | codeview review --diff -                  # any diff

パブリックリポジトリはトークンなしで利用できます。プライベートリポジトリを使う場合、またはレビューを投稿する場合は、GITHUB_TOKEN を設定してください。 gh CLI にログインしている場合は、そのトークンが自動的に取得されます。

その他の便利なオプション：

-f, --format text|markdown|json|sarif
-o, --output FILE
--json-output FILE / --sarif-output FILE   write extra reports in the same run
--post [--dry-run]                         publish the review to the PR as inline comments
--fail-on high                             exit 1 if any finding is high or worse (default: high)
--max-risk 60                              exit 1 if the risk score is above 60
--no-ai                                    rules only
--provider gemini --model ...              pick the AI provider/model
--focus security                           ask the AI to concentrate on something

codeview rules はすべてのルールを一覧表示し、codeview providers は設定済みの AI プロバイダーを表示します。また、codeview init は初期設定用の設定ファイルを書き込みます。

AI プロバイダー

次のいずれかを設定してください。複数設定されている場合は、次の順に試行し、失敗した場合またはレート制限に達した場合は次に進みます。

プロバイダー	環境変数	キーの取得先
Google Gemini	GEMINI_API_KEY	https://aistudio.google.com/apikey
Groq	GROQ_API_KEY	https://console.groq.com/keys
Cerebras	CEREBRAS_API_KEY	https://cloud.cerebras.ai
OpenRouter（無料モデル）	OPENROUTER_API_KEY	https://openrouter.ai/keys
Ollama（ローカル）	CODEVIEW_OLLAMA=1 または OLLAMA_HOST	https://ollama.com
任意の OpenAI 互換 API	CODEVIEW_BASE_URL、CODEVIEW_MODEL、CODEVIEW_API_KEY

各プロバイダーには、無料枠に適したデフォルトモデルが設定されています。codeview providers でモデルを確認でき、--model または CODEVIEW_MODEL で上書きできます。差分は各プロバイダーの制限に収まるように切り詰められ、レスポンスはローカルにキャッシュされるため、同じ差分を再度レビューしてもクォータは消費されません。

プロバイダーが設定されていない場合でも、ルールは実行されます。

MCP サーバー

MCP クライアントの設定に次の内容を追加してください（Cursor、Windsurf、Zed などもこの形式を使用します）。

{
  "mcpServers": {
    "codeview": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/mann-uofg/codeview-mcp", "codeview", "serve"],
      "env": { "GEMINI_API_KEY": "...", "GITHUB_TOKEN": "..." }
    }
  }
}

VS Code の場合は、同じ内容を .vscode/mcp.json の "servers" の下に "type": "stdio" とともに記述してください。 codeview serve --http を実行すると、127.0.0.1:8765/mcp で Streamable HTTP サーバーが起動します。

ツール：

• review_pull_request：PR をレビューします
• review_local_changes：作業ツリー、ステージ済みの変更、またはブランチの変更をレビューします
• review_diff_text：テキストとして渡された差分をレビューします
• get_pull_request_diff：アシスタントが自分で確認するための、PR メタデータと行番号付きの差分を取得します
• post_review：レビューを GitHub に投稿します。dry_run=false が渡されない限りドライランとなり、すでに投稿されたコメントはスキップされます。
• list_rules、provider_status

プロンプト（deep_review、security_audit、suggest_tests、review_my_changes）とリソース（codeview://rules、codeview://providers、codeview://config/example）も提供します。

GitHub Action

name: codeview
on: pull_request

permissions:
  contents: read
  pull-requests: write     # to post the review
  security-events: write   # only needed for the SARIF upload

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: mann-uofg/codeview-mcp@v2
        with:
          gemini-api-key: ${{ secrets.GEMINI_API_KEY }}   # optional
          fail-on: critical
      - uses: github/codeql-action/upload-sarif@v4
        if: always()
        with:
          sarif_file: codeview.sarif

この Action は、概要とインラインコメントを含むレビューを 1 件投稿し、ジョブの概要を書き込み、risk-score、risk-level、verdict、findings の出力を設定します。フォークからのプルリクエストには読み取り専用トークンが付与されるため、レビューは投稿されませんが、ジョブの概要と SARIF は引き続き機能します。すべての入力は action.yml に記載されています。

設定

リポジトリのルートに .codeview.toml を配置するか、pyproject.toml に [tool.codeview] テーブルを追加します。

provider = "auto"
min_severity = "low"          # hide findings below this
fail_on = "high"              # or "never"
max_findings = 30
exclude = ["docs/**", "**/*.generated.ts"]
disable_rules = ["CV-QUAL-006"]
focus = ["security"]
instructions = "We use SQLAlchemy 2.x. Flag raw SQL built with string formatting."

[[custom_rules]]
id = "TEAM-001"
pattern = "print\\("
message = "Use the logger instead of print()."
severity = "low"
paths = ["src/**/*.py"]

1 行を無視するには、その行に codeview-ignore コメントを追加します。特定のルールを無視するには、cv-ignore[CV-SEC-020] を追加します。

プルリクエストをレビューするとき、設定は PR ではなくベースブランチから読み込まれます。これにより、PR で検出を無効にできないようにしています。

セキュリティに関する注意

codeview は他の人が制御する入力を読み取るため、次の対策を行っています。

• 差分と PR のテキストはデータとしてモデルに渡され、その中に書かれた指示には従わないよう指示されます。モデルの回答は検証され、差分に含まれていないファイルや行を指し示す検出結果は破棄されます。
• GitHub に投稿されるテキストでは、@mentions、課題をクローズするキーワード、画像、HTML コメントが無効化されます。
• ローカルの git コマンドでは、外部 diff ドライバー、textconv、fsmonitor、ページャーが無効になります。参照は検証され、シンボリックリンクはたどりません。
• 受け付けるのは、GitHub ホスト上の PR URL のみです。API キーが、ローカル以外のホストへ平文の HTTP で送信されることはありません。
• HTTP トランスポートは localhost のみで待ち受け、Host/Origin ヘッダーを検証します。

脆弱性を報告するには、SECURITY.md をご覧ください。

開発

git clone https://github.com/mann-uofg/codeview-mcp
cd codeview-mcp
uv sync
uv run pytest
uv run ruff check . && uv run mypy

CONTRIBUTING.md をご覧ください。変更内容は CHANGELOG.md に記載されています。

ライセンス

MIT