dotnet-coverage-mcp

Claude Code、Gemini CLI などのAIアシスタントに .NET のテストカバレッジツールへの直接アクセスを提供する MCP (Model Context Protocol) サーバーです。dotnet test の実行、Cobertura XML の解析、未カバーのブランチの特定、実行間のカバレッジ差分、テストコードの追加を、すべて stdio 経由で行えます。

目的

このサーバーにより、AIアシスタントはチャットから離れることなく、単体テストの実行、カバレッジデータの収集、結果の分析を行うことができます。dotnet test を手動で実行してレポートを解析する代わりに、AI はサーバーのツールを直接呼び出して次のことができます:

• ソースファイルを発見し、行数予算に基づいてスマートなバッチを作成

• フィルタリングされたテストセットを実行してカバレッジを収集

• コンパクトで AI 向けに最適化されたカバレッジサマリーを読み取る（メソッドレベルの行/ブランチ率）

• 設定可能な目標率（デフォルト 80%）に対するファイルごとのカバレッジを確認

• 未カバーのブランチを構造化 JSON として特定

• 実行間のカバレッジ差分を確認し、変更された部分だけを把握

• 既存のテストファイルに新しいテストコードをアトミック書き込みで追加

Related MCP server: codecov-mcp-server

仕組み

サーバーはコンソールプロセスとして起動し、MCP プロトコルを使用して stdio 上で通信します。MCP 互換クライアント（Claude Code、Gemini CLI など）がプロセスを起動し、そのツールをあたかも関数であるかのように呼び出します。

AI Client  <--stdio/MCP-->  dotnet-coverage-mcp  <--shell-->  dotnet test + reportgenerator

利用可能なツール

バッチワークフロー

ソースファイルが多いプロジェクトでは、次のワークフローが推奨されます:

1. 発見 — フォルダまたは .csproj に対して GetSourceFiles を呼び出し、すべてのファイルとスマートバッチを取得

2. 一度実行 — 広いフィルター（例: *）で RunTestsWithCoverage を呼び出し、全ファイルのカバレッジを収集

3. ファイルごとに確認 — 現在のバッチ内の各ファイルに対して GetFileCoverage を呼び出す（即時 XML 解析、テストの再実行なし）

4. 集中 — ブランチカバレッジが最も低い3つのメソッドを選び、それぞれに対して GetUncoveredBranches を呼び出す

5. テストを書く — AppendTestCode を使用してテストメソッドを追加

6. 再実行して差分を確認 — テストを一度実行し、GetCoverageDiff を呼び出して改善を検証

7. 繰り返す — バッチ内のファイルが目標率（デフォルト 80%）を満たすか、改善のないサイクルが3回続くまで続け、その後次のバッチへ

これにより、dotnet test の呼び出し（主なボトルネック）を最小限に抑えながら、ファイルごとの進捗を追跡できます。

並行性

複数の AI エージェントは、各ツール呼び出しに sessionId を渡すことで並行実行でき、カバレッジアーティファクトを分離できます:

• 分離された出力ディレクトリ — RunTestsWithCoverage はセッションごとに TestResults-{hash}/ と coveragereport-{hash}/ を作成し、あるエージェントが別のエージェントの XML を解析中に削除するのを防ぎます

• スコープ付き状態ファイル — カバレッジ状態は .mcp-coverage/.coverage-state-{hash} に書き込まれるため、ResolveCoberturaPath は各セッションの正しい XML を解決します

• スコープ付きベースライン — GetCoverageDiff はベースラインをセッションごとに .coverage-prev-{hash}.xml として保存します

• アトミック書き込み — すべてのファイル書き込み（状態ファイルとテストコード）は、一時ファイルへの書き込み後にリネームする方式を使用し、競合状態やプロセスクラッシュによる破損を防ぎます

制限 — ビルド出力はセッションスコープではありません。 sessionId はカバレッジアーティファクトを分離しますが、.NET ビルドは分離しません。dotnet test は対象プロジェクトを共有の obj/ と bin/ にコンパイルしますが、これらはセッションごとではないため、同じテストプロジェクトに対して同時に RunTestsWithCoverage を実行する2つのエージェントは、それらの出力で衝突し、buildError（例: CS2012: the file is being used by another process）で失敗します。並行エージェントは異なるテストプロジェクトに対して実行するか、リポジトリの別々の作業コピーで実行してください。1つのプロジェクトで複数のエージェントを実行する場合も、dotnet test のビルドが重ならなければ問題ありません。

sessionId がない場合、ツールは共有のデフォルトを使用します — 単一エージェントでの使用には安全です。

要件

• .NET 9.0 SDK（以降） — https://dotnet.microsoft.com/download

• reportgenerator グローバルツール — サーバーはカバレッジレポートをレンダリングするためにこれを外部プロセスとして呼び出します（下記のインストール手順でインストール）

• MCP 互換クライアント（Claude Code、Gemini CLI など）

• COVERAGE_MCP_ALLOWED_ROOT — 推奨。リポジトリのルートに設定すると、すべてのツールのファイルシステムアクセスがそのサブツリーに制限されます。クライアントがこのルートの外に渡したパスは pathNotAllowed で拒否されます。未設定の場合、サーバーは一度警告をログに記録し、任意のパスを受け入れます（後方互換性のためですが、共有環境では推奨されません）。

  export COVERAGE_MCP_ALLOWED_ROOT=/path/to/your/repo

インストール

サーバーを NuGet からグローバル .NET ツールとしてインストールします:

dotnet tool install --global dotnet-coverage-mcp

サーバーはカバレッジレポートをレンダリングするために reportgenerator グローバルツールに依存しています — これもインストールしてください:

dotnet tool install --global dotnet-reportgenerator-globaltool

インストール後、dotnet-coverage-mcp コマンドが PATH に追加されます。

ビルドと実行（ソースから）

cd <path-to-dotnet-coverage-mcp>

# Restore dependencies
dotnet restore

# Build
dotnet build

# Run
dotnet run

サーバーが起動し、stdin/stdout 経由で MCP メッセージを待機します。

MCP クライアント設定

グローバルツールをインストールした後（dotnet tool install --global dotnet-coverage-mcp）、 サーバーを MCP クライアントに登録します。COVERAGE_MCP_ALLOWED_ROOT を サーバーが操作するリポジトリに設定してください。

Claude Code

claude mcp add coverage --env COVERAGE_MCP_ALLOWED_ROOT=/path/to/your/repo -- dotnet-coverage-mcp

Claude Desktop

claude_desktop_config.json に追加します（設定 → 開発者 → 設定を編集）:

{
  "mcpServers": {
    "coverage": {
      "command": "dotnet-coverage-mcp",
      "env": {
        "COVERAGE_MCP_ALLOWED_ROOT": "/path/to/your/repo"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクトごと）に追加します:

{
  "mcpServers": {
    "coverage": {
      "command": "dotnet-coverage-mcp",
      "env": {
        "COVERAGE_MCP_ALLOWED_ROOT": "/path/to/your/repo"
      }
    }
  }
}

VS Code (GitHub Copilot)

.vscode/mcp.json に追加します:

{
  "servers": {
    "coverage": {
      "type": "stdio",
      "command": "dotnet-coverage-mcp",
      "env": {
        "COVERAGE_MCP_ALLOWED_ROOT": "/path/to/your/repo"
      }
    }
  }
}

ソースから実行

グローバルツールの代わりにソースから実行するには、dotnet run を使用します:

{
  "mcpServers": {
    "coverage": {
      "command": "dotnet",
      "args": ["run", "--project", "<path-to-dotnet-coverage-mcp>"],
      "transport": "stdio"
    }
  }
}

または、コンパイル済みの実行可能ファイルを直接指定します:

{
  "mcpServers": {
    "coverage": {
      "command": "<path-to-dotnet-coverage-mcp>\\bin\\Debug\\net9.0\\DotNetCoverageMcp.exe",
      "transport": "stdio"
    }
  }
}

ツールパラメータ

GetSourceFiles

RunTestsWithCoverage

GetCoverageSummary

GetFileCoverage

GetUncoveredBranches

GetCoverageDiff

AppendTestCode

CleanupSession

状態ファイル

すべての状態ファイルは作業ディレクトリ内の .mcp-coverage/ サブディレクトリに書き込まれ、プロジェクトルートをクリーンに保ちます。ターゲットリポジトリの .gitignore に .mcp-coverage/ を追加してください。

プラグイン（スキルとエージェント）

このリポジトリには、ガイド付きテストカバレッジワークフローのための Claude Code スキルとエージェント定義を含む plugin/ ディレクトリが含まれています:

plugin/
├── plugin.json
├── agents/
│   └── test-coverage.agent.md
└── skills/
    ├── scaffold-test-files/     — Create test directories and files mirroring source structure
    ├── run-coverage/            — Run tests and view coverage reports
    ├── analyze-coverage-gaps/   — Find uncovered branches and compare diffs
    └── improve-test-coverage/   — Iterative loop to reach 80% coverage

スキルは NUnit、xUnit、MSTest をサポートし、references/unit.md と references/integration.md にフレームワーク非依存のリファレンスドキュメントがあります。

依存関係

セキュリティ

dotnet-coverage-mcp はローカルの stdio プロセスとして動作し、すべてのツール引数を COVERAGE_MCP_ALLOWED_ROOT に対して検証してファイルシステムアクセスを制限します。脅威モデル、ハードニングの推奨事項、脆弱性の報告方法については SECURITY.md を参照してください。

コントリビューション

コントリビューションを歓迎します。開発環境のセットアップ、プルリクエストのガイドライン、コード規約については CONTRIBUTING.md を参照してください。主な変更は CHANGELOG.md に記録されています。

リリース

メンテナーのみ — リリースプロセス、NuGet 公開、MCP レジストリへの提出は RELEASING.md に文書化されています。