CoverageX.McpServer 0.1.0

CoverageX

CoverageX is a report-first incremental coverage tool for .NET.

Its job is not to produce coverage XML. Its job is to take existing coverage XML plus Git diff context and generate incremental coverage reports that focus on changed code.

Product Focus

CoverageX now focuses on two report workflows:

1. lreport: local runtime source tree
2. areport: artifact or managed runtime source tree

The MCP server exposes the matching two tools:

1. GenerateLocalIncrementalReport
2. GenerateArtifactIncrementalReport

CoverageX no longer wraps coverage collection lifecycle commands. If you need coverage XML, run your preferred tool directly, then pass the resulting XML into CoverageX.

Input Strategy

CoverageX resolves report inputs in this order:

1. report-input-files adds one or more explicit XML files separated by ;.
2. report-input-directories adds one or more directories separated by ;, whose *.xml files will be scanned recursively.

CoverageX no longer auto-discovers XML from nested output subdirectories during report generation.

Quick Start

Local runtime source tree:

coveragex lreport \
  --source feature/foo \
  --target main \
  --source-directory /path/to/repo \
  --report-input-directories ./artifacts/coverage

Artifact runtime source tree:

coveragex areport \
  --source release/1.2 \
  --target main \
  --repository-url https://github.com/your-org/sample-api.git \
  --report-input-files ./artifacts/coverage.cobertura.xml

Environment Requirements

At minimum, the machine running CoverageX needs:

1. a working .NET runtime
2. access to the Git repository or managed source tree used for diff analysis
3. one or more existing coverage XML files, or one or more directories that already contain those XML files
4. for areport, an explicit repository-url when CoverageX needs to materialize the managed runtime source tree
5. if your MCP installation path uses dnx, availability of dnx

CoverageX itself no longer requires dotnet-coverage. That dependency only matters if you personally choose it as your external XML producer.

Installation

Agent Skill installation and first-run flow for Codex/Cursor:

1. docs/for-users/agent-skill-usage.md

Recommended MCP install flow:

1. docs/for-users/mcpserver-nuget-usage.md

Local MCP development flow:

1. docs/for-users/mcpserver-local-usage.md

Local CLI packaging flow:

./CoverageAI/package-tool.sh
dotnet tool install --global CoverageX.Command --add-source ./CoverageAI/artifacts/nuget

Main Docs

1. docs/for-users/agent-skill-usage.md
2. docs/for-users/cli-usage.md
3. docs/for-users/mcpserver-tool-reference.md
4. docs/for-users/mcpserver-local-usage.md
5. docs/for-users/mcpserver-nuget-usage.md
6. docs/for-developers/incremental-analysis.md
7. docs/for-developers/cli-parameter-resolution.md
8. docs/for-developers/distribution.md

Capability Summary

CoverageX currently supports:

1. local-source incremental report generation
2. artifact-source incremental report generation
3. Git diff based changed-line filtering
4. stdio and http MCP transports
5. ReportGenerator-based incremental report output