Test Coverage MCP

🚀 テストカバレッジMCP

コードを生成するエージェントにカバレッジの認識能力を与えましょう

このMCPサーバーは、あらゆるプログラミング言語（LCOVベース）に対して、即時で信頼性の高い、トークン効率の良いテストカバレッジデータを提供します。

🚀 2025年11月にリリースされました！このライブラリの磨きに日々力を注いでいます。もしこれが役に立つと思ったら、⭐ スターをつけることで他の開発者にこのプロジェクトが注目に値することを知らせることができます。

🚀 クイックスタート

このMCPサーバーを使用することで、AIコーディングエージェントがコードを扱う際のテストカバレッジに関する問題を解決できます。以下に、主な機能や使い方を説明します。

✨ 主な機能

解決する問題

AIコーディングエージェントが適切なカバレッジツールを使わずにコードに取り組むと、次の3つの重大な問題に直面します。

1. カバレッジの盲目性 - 変更がテストカバレッジを向上させたのか低下させたのかを把握できません。
2. トークンの浪費 - 巨大なLCOVファイル（一部は10MBを超える）を解析するために数千のトークンを消費します。
3. 信頼性の低いスクリプト - カスタムの解析スクリプトを即興で作成するため、しばしば失敗したり誤った結果を生み出したりします。

解決策

このMCPサーバーは、以下の機能を提供することでこれらの問題をすべて解決します。

• カバレッジの認識 - エージェントは簡単なツール呼び出しでいつでもカバレッジを確認できます。
• トークンの効率性 - 数千のトークンを使う代わりに、100トークン未満でカバレッジの要約を取得できます。
• 正確性 - すべての形式のバリエーションを処理する本番グレードのLCOV解析を行います。
• ベースラインの追跡 - メモリに状態を保持することなく、セッション内でのカバレッジの進捗を測定できます。

テストカバレッジ：このプロジェクトは95%のテストカバレッジを維持しており、近い将来100%を目指しています。

📦 インストール

npm install -g test-coverage-mcp

📚 ドキュメント

2つの主要なワークフロー

1. カバレッジ要約のクエリ

プロジェクト全体のカバレッジまたは特定のファイルのカバレッジを問い合わせます。

// プロジェクト全体のカバレッジを取得
coverage_summary({ lcovPath: "./coverage/lcov.info" });
// 返り値: { linesCoveragePercentage: 87.5, branchesCoveragePercentage: 82.1 }

// 特定のファイルのカバレッジを取得
coverage_file_summary({
  lcovPath: "./coverage/lcov.info",
  filePath: "src/utils/parser.ts",
});
// 返り値: { path: "src/utils/parser.ts", linesCoveragePercentage: 92.0, branchesCoveragePercentage: 88.5 }

2. セッション進捗のベースライン追跡

セッション開始時にベースラインを設定し、進捗を測定します。

// セッション開始時 - 現在のカバレッジをベースラインとして記録
start_recording({ lcovPath: "./coverage/lcov.info" });
// 返り値: "Recording started"

// ... エージェントがコードとテストを書く ...

// カバレッジの影響を確認
get_diff_since_start({ lcovPath: "./coverage/lcov.info" });
// 返り値: { linesPercentageImpact: +2.3, branchesPercentageImpact: +1.8 }

なぜベースライン追跡が必要なのか？ ベースライン追跡がないと、エージェントはセッション全体で初期のカバレッジを状態メモリに保持する必要があり、貴重なコンテキストウィンドウのスペースを消費します。

設定

このMCPサーバーをAIコーディングツールの設定に追加します。

Claude Desktop (Claude Code)

macOS：~/Library/Application Support/Claude/claude_desktop_config.json を編集します。 Windows：%APPDATA%\Claude\claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "test-coverage": {
      "command": "npx",
      "args": ["-y", "test-coverage-mcp"]
    }
  }
}

更新後、Claude Desktopを再起動します。

Cursor IDE

プロジェクトルートに .cursor/mcp.json を作成または編集します。

{
  "mcpServers": {
    "test-coverage": {
      "command": "npx",
      "args": ["-y", "test-coverage-mcp"]
    }
  }
}

GitHub Copilot (VS Code)

ワークスペースに .vscode/mcp.json を作成または編集します。

{
  "servers": {
    "test-coverage": {
      "command": "npx",
      "args": ["-y", "test-coverage-mcp"]
    }
  }
}

VS Code 1.99+ または Visual Studio 17.14+ が必要です。エンタープライズユーザーは "MCP servers in Copilot" ポリシーを有効にする必要があります。

Windsurf (Codeium IDE)

macOS：~/.codeium/windsurf/mcp_config.json を編集します。 Windows：%APPDATA%\Codeium\Windsurf\mcp_config.json を編集します。 Linux：~/.codeium/windsurf/mcp_config.json を編集します。

{
  "mcpServers": {
    "test-coverage": {
      "command": "npx",
      "args": ["-y", "test-coverage-mcp"]
    }
  }
}

またはGUIを使用して、Settings → Advanced Settings → Cascade → Add Server から追加できます。

利用可能なツール

coverage_summary

LCOVファイルからプロジェクト全体のカバレッジを取得します。 入力：

{
  lcovPath?: string  // オプション。デフォルトは "./coverage/lcov.info"
}

出力：

{
  linesCoveragePercentage: number,      // 0-100
  branchesCoveragePercentage: number    // 0-100
}

例：

coverage_summary({ lcovPath: "./coverage/lcov.info" });
// { linesCoveragePercentage: 87.5, branchesCoveragePercentage: 82.1 }

coverage_file_summary

特定のファイルのカバレッジを取得します。 入力：

{
  lcovPath?: string,  // オプション。デフォルトは "./coverage/lcov.info"
  filePath: string    // 必須。ファイルのパス
}

出力：

{
  path: string,
  linesCoveragePercentage: number,      // 0-100
  branchesCoveragePercentage: number    // 0-100
}

例：

coverage_file_summary({
  lcovPath: "./coverage/lcov.info",
  filePath: "src/utils/parser.ts",
});
// { path: "src/utils/parser.ts", linesCoveragePercentage: 92.0, branchesCoveragePercentage: 88.5 }

start_recording

現在のカバレッジを後で比較するためのベースラインとして記録します。 入力：

{
  lcovPath: string; // 必須。記録するLCOVファイルのパス
}

出力：

"Recording started";

例：

start_recording({ lcovPath: "./coverage/lcov.info" });
// "Recording started"

get_diff_since_start

現在のカバレッジを記録されたベースラインと比較します。 入力：

{
  lcovPath: string; // 必須。現在のLCOVファイルのパス
}

出力：

{
  linesPercentageImpact: number,      // 正 = 改善、負 = 低下
  branchesPercentageImpact: number    // 正 = 改善、負 = 低下
}

例：

get_diff_since_start({ lcovPath: "./coverage/lcov.info" });
// { linesPercentageImpact: +2.3, branchesPercentageImpact: +1.8 }

💻 使用例

例1: 作業開始前にカバレッジを確認する

エージェント: "作業を開始する前に、現在のテストカバレッジを確認しましょう"
[coverage_summaryツールを使用]
エージェント: "現在のカバレッジは行カバレッジが87.5%、分岐カバレッジが82.1%です。これを維持または向上させます。"

例2: 開発中にカバレッジの影響を追跡する

エージェント: "まずベースラインのカバレッジを記録します"
[start_recordingツールを使用]

エージェント: "次に、新しい認証機能とテストを追加します"
[コードとテストを書く]

エージェント: "カバレッジの影響を確認しましょう"
[get_diff_since_startツールを使用]
エージェント: "素晴らしい！行カバレッジが2.3%、分岐カバレッジが1.8%向上しました。"

例3: 特定のファイルのカバレッジを検証する

エージェント: "私が修正したファイルのカバレッジを確認しましょう"
[filePath: "src/auth/validator.ts" でcoverage_file_summaryを使用]
エージェント: "validator.tsファイルの現在の行カバレッジは95%、分岐カバレッジは92%です。"

仕組み

このMCPサーバーは以下のように動作します。

1. LCOVファイルを解析する - すべてのLCOV形式のバリエーションを処理する本番グレードのパーサーを使用します。
2. カバレッジの割合を計算する - プロジェクト全体または個々のファイルのカバレッジ割合を計算します。
3. ベースラインを保存する - セッションベースの追跡のために一時ディレクトリにベースラインを保存します。
4. コンパクトなJSONを返す - 最小限のトークンを消費するコンパクトなJSONレスポンスを返します。

LCOV形式のサポート

このサーバーは、すべての標準的なLCOVファイル形式をサポートしています。

• 要約セクション（SF:、end_of_record）を持つファイル
• 行単位のデータのみ（DA: エントリ）を持つファイル
• 分岐カバレッジデータ（BRDA:、BRF:、BRH:）を持つファイル
• 同じファイル内に混合形式を持つファイル

トラブルシューティング

"LCOV file not found"

• まず、カバレッジを有効にしてテストスイートを実行してください。
• LCOVファイルのパスが正しいことを確認してください（相対パスは現在の作業ディレクトリから解決されます）。
• デフォルトのパスは ./coverage/lcov.info です。

"No coverage data found for file"

• ファイルパスがLCOVファイルに表示されるものと正確に一致することを確認してください。
• 一部のテストフレームワークは絶対パスを使用し、他のフレームワークは相対パスを使用します。

"No baseline recording found"

• get_diff_since_start を呼び出す前に start_recording を呼び出す必要があります。
• ベースラインは一時ストレージに保存され、システムが再起動するとクリアされます。

開発

# 依存関係をインストール
npm install

# ビルド
npm run build

# テストを実行（カバレッジ付き！）
npm test

# リンターを実行
npm run lint

# MCPインスペクターでテスト
npm run inspect

コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

MIT © Yoni Goldberg

リンク

• GitHubリポジトリ
• npmパッケージ
• MCPドキュメント
• 問題の報告

改善案

• coverage_file_summaryがネストされたプロパティもフラットに宣言して返す
• 記録の開始が他のセッションファイルを上書きする
• 記録名を改善する - setSessionBaseline、getDiffSinceBaseline