dotnet-coverage-mcp

MCP-сервер (Model Context Protocol), который предоставляет AI-ассистентам — Claude Code, Gemini CLI и другим — прямой доступ к инструментам покрытия .NET-тестов. Запускайте dotnet test, разбирайте Cobertura XML, находите непокрытые ветви, сравнивайте покрытие между запусками и добавляйте тестовый код — всё через stdio.

Назначение

Этот сервер позволяет AI-ассистенту запускать модульные тесты, собирать данные о покрытии и анализировать результаты — не выходя из чата. Вместо ручного запуска dotnet test и разбора отчётов AI может напрямую вызывать инструменты сервера, чтобы:

• Находить исходные файлы и формировать умные пакеты по бюджету строк

• Запускать отфильтрованный набор тестов и собирать покрытие

• Читать компактные сводки покрытия, оптимизированные для AI (показатели строк и ветвей на уровне методов)

• Проверять покрытие по каждому файлу относительно настраиваемой целевой нормы (по умолчанию 80%)

• Выявлять непокрытые ветви в виде структурированного JSON

• Сравнивать покрытие между запусками, чтобы видеть только изменения

• Добавлять новый тестовый код в существующий файл тестов с атомарной записью

Related MCP server: codecov-mcp-server

Как это работает

Сервер запускается как консольный процесс и общается через stdio по протоколу MCP. MCP-совместимый клиент (Claude Code, Gemini CLI и т. д.) запускает процесс и вызывает его инструменты, как если бы это были функции.

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

Доступные инструменты

Пакетный рабочий процесс

Для проектов с большим количеством исходных файлов рекомендуется следующий порядок действий:

1. Обнаружение — вызовите GetSourceFiles для папки или .csproj, чтобы получить все файлы и умные пакеты

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 для одного и того же тестового проекта, сталкиваются при записи в эти выходные данные и завершаются с buildError (например, CS2012: the file is being used by another process). Запускайте параллельных агентов для разных тестовых проектов или в отдельных рабочих копиях репозитория. Несколько агентов в одном проекте допустимы, если их сборки 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

Установка

Установите сервер как глобальный инструмент .NET из NuGet:

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

Сервер запустится и будет ожидать MCP-сообщений через stdin/stdout.

Настройка 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 (Settings → Developer → Edit Config):

{
  "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/ внутри рабочего каталога, сохраняя корень проекта чистым. Добавьте .mcp-coverage/ в .gitignore целевого репозитория.

Плагин (навыки и агент)

Этот репозиторий включает каталог plugin/ с навыками Claude Code и определением агента для управляемых рабочих процессов покрытия тестами:

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 для настройки разработки, правил pull request и соглашений по коду. Заметные изменения отслеживаются в CHANGELOG.md.

Выпуск

Только для сопровождающих — процесс выпуска, публикация в NuGet и отправка в реестр MCP описаны в RELEASING.md.