.NET测试覆盖率工具

.net覆盖mcp

一个MCP（模型上下文协议）服务器，为人工智能助手（Claude Code、Gemini CLI等）提供直接访问。NET测试覆盖率工具。运行dottest，解析Cobertura XML，识别未覆盖的分支，运行之间的覆盖率差异，并在整个stdio中附加测试代码。

目的

该服务器允许AI助手运行单元测试、收集覆盖率数据并分析结果，所有这些都不需要离开聊天室。而不是手动运行 dotnet test AI可以直接调用服务器的工具来：

• 发现源文件并按行预算构建智能批处理
• 运行一组经过筛选的测试并收集覆盖率
• 阅读紧凑、人工智能优化的覆盖率摘要（方法级线路/分支率）
• 根据可配置的目标速率（默认80%）检查每个文件的覆盖率
• 将未覆盖的分支识别为结构化JSON
• 跑步之间的覆盖范围不同，只看有什么变化
• 使用原子写入将新测试代码附加到现有测试文件

运作原理

服务器作为控制台进程启动，并通过以下方式进行通信 标准 使用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 每次会话
• 原子写入 --所有文件写入（状态文件和测试代码）都使用write-to-temp，然后重命名，以防止竞争条件或进程崩溃造成的损坏

限制——构建输出不在会话范围内。 sessionId 隔离覆盖率 人工制品，而不是。网 建造. 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

• 报表生成器 全局工具——服务器向其发送shell以呈现覆盖率报告（安装在 安装 下一步）

• 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

服务器依赖于 报表生成器 呈现覆盖率报告的全局工具--也安装它：

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 代码

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

克劳德桌面

增添 claude_desktop_config.json （设置→ 开发者→ 编辑配置）：

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

光标

增添 ~/.cursor/mcp.json （全球）或 .cursor/mcp.json （每个项目）：

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

VS代码（GitHub副本）

增添 .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.

依赖项

安全

netscoverage-mcp作为本地stdio进程运行，并验证每个工具参数 COVERAGE_MCP_ALLOWED_ROOT 限制文件系统访问。看 安全.md 对于威胁模型，强化建议，以及如何报告漏洞。

贡献

欢迎捐款。看 贡献.md 为了发展 设置、拉取请求准则和代码约定。跟踪显著变化 在 更改日志.md.

释放

仅限维护者——发布过程、NuGet发布和MCP注册表提交记录在 发布.md.