Test Coverage MCP Server

.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    dotnet-coverage-mcp    dotnet test + reportgenerator

可用工具

批处理工作流

对于具有许多源文件的项目，建议的工作流程是：

1. 发现 --呼叫 GetSourceFiles 在文件夹或 .csproj 获取所有文件和智能批处理
2. 跑一次 --呼叫 RunTestsWithCoverage 使用宽滤波器（例如。， *)收集所有文件的覆盖率
3. 按文件检查 --呼叫 GetFileCoverage 对于当前批处理中的每个文件（即时XML解析，无需重新运行测试）
4. 聚焦 --选择3种最低的分支覆盖率方法并调用 GetUncoveredBranches 对于每一个
5. 编写测试 --使用 AppendTestCode 添加测试方法
6. 重新运行和差异 --运行一次测试，调用 GetCoverageDiff 验证改进
7. 重复 --继续，直到批处理文件达到目标速率（默认80%）或3个周期没有改进，然后移动到下一批

这最大限度地减少了 dotnet test 调用（主要瓶颈），同时仍跟踪每个文件的进度。

并发

通过传递 sessionId 对于每个工具调用：

• 独立输出目录 — RunTestsWithCoverage 创造 TestResults-{hash}/ 和 coveragereport-{hash}/ 每个会话，防止一个代理在解析过程中删除另一个代理的XML
• 作用域状态文件 --覆盖状态写入 .mcp-coverage/.coverage-state-{hash}，所以 ResolveCoberturaPath 解析为每个会话的正确XML
• 范围基线 — GetCoverageDiff 将基线存储为 .coverage-prev-{hash}.xml 每次会话
• 原子写入 --所有文件写入（状态文件和测试代码）都使用write-to-temp，然后重命名，以防止竞争条件或进程崩溃造成的损坏

没有 sessionId，工具使用共享默认值——对单个代理使用是安全的。

需求

• .NET 9.0 SDK（或更高版本） —

• 报表生成器 全局工具--安装一次：

  dotnet tool install --global dotnet-reportgenerator-globaltool

• 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-coverage-mcp 命令位于PATH中。

构建和运行（从源代码）

cd 

# Restore dependencies
dotnet restore

# Build
dotnet build

# Run
dotnet run

服务器将启动并通过stdin/stdout等待MCP消息。

MCP客户端配置

如果您是通过安装的 dotnet tool，将MCP客户端指向全局命令：

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

若要从源代码运行，请使用 dotnet run:

{
  "mcpServers": {
    "coverage": {
      "command": "dotnet",
      "args": ["run", "--project", "
"],
      "transport": "stdio"
    }
  }
}

或者直接指向已编译的可执行文件：

{
  "mcpServers": {
    "coverage": {
      "command": "
\\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.