dotnet-coverage-mcp

MCP(Model Context Protocol) 서버로, Claude Code, Gemini CLI 등 AI 어시스턴트에게 .NET 테스트 커버리지 도구에 대한 직접 액세스를 제공합니다. dotnet test 실행, Cobertura XML 파싱, 커버되지 않은 브랜치 식별, 실행 간 커버리지 비교(diff), 테스트 코드 추가를 모두 stdio를 통해 수행합니다.

목적

이 서버는 AI 어시스턴트가 채팅을 벗어나지 않고도 단위 테스트를 실행하고, 커버리지 데이터를 수집하며, 결과를 분석할 수 있게 해줍니다. dotnet test를 수동으로 실행하고 보고서를 파싱하는 대신, AI가 서버의 도구를 직접 호출하여 다음을 수행할 수 있습니다:

• 소스 파일을 검색하고 라인 예산(line budget) 기준으로 스마트 배치 구성

• 필터링된 테스트 집합을 실행하고 커버리지 수집

• 간결하고 AI에 최적화된 커버리지 요약 읽기(메서드 수준 라인/브랜치 비율)

• 구성 가능한 목표 비율(기본 80%)에 대한 파일별 커버리지 확인

• 커버되지 않은 브랜치를 구조화된 JSON으로 식별

• 실행 간 커버리지 비교(diff)로 변경된 사항만 확인

• 기존 테스트 파일에 새 테스트 코드를 원자적 쓰기(atomic write)로 추가

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. 1회 실행 — 광범위한 필터(예: *)로 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로 저장합니다

• 원자적 쓰기 — 모든 파일 쓰기(상태 파일 및 테스트 코드)는 임시 파일에 쓴 후 이름을 바꾸는 방식(write-to-temp-then-rename)을 사용하여 경쟁 조건이나 프로세스 충돌로 인한 손상을 방지합니다

제한 사항 — 빌드 출력물은 세션 범위로 격리되지 않습니다. 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

설치

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에 문서화되어 있습니다.