covdbg MCP server

covdbg-mcp

MCP server for covdbg: C++ code coverage on Windows for AI agents. Run tests, find uncovered code, and add targeted tests. No rebuild required.

covdbg measures coverage of the Windows x64 binaries you already build, using their PDB debug information. It works like a debugger: it starts your executable, reads the PDB, and places lightweight probes while the program runs. The MCP server is built into the covdbg executable (since v1.3.0) and is started with covdbg mcp.

This repository holds the MCP registry metadata (server.json, glama.json) and the MCP Bundle manifest (manifest.json) for covdbg. The server itself ships with covdbg.

What an agent can do

1. Run coverage on a test executable without rebuilding it.
2. Rank files by uncovered lines.
3. Read the uncovered code with surrounding context.
4. Add a focused test, re-run it, and confirm the gap is closed.
5. Query and merge coverage databases (.covdb) with read-only SQL.

Requirements

• Windows x64
• covdbg 1.3.0 or newer
• An executable with PDB debug symbols (MSVC or any PDB-producing toolchain)
• A one-time covdbg login (covdbg 1.4 and newer sign in to one team, and runs need a seat in that team), or COVDBGPROJECTTOKEN for CI
• A .covdbg.yaml next to the target executable, or a config_path passed to run (see the configuration reference)

Install covdbg

• Installer (recommended): installer.msi. It installs to %LocalAppData%\Programs\Liasoft\covdbg and adds that directory to your user PATH.
• Portable: portable.zip. Extract it anywhere and add the directory to your PATH yourself.

Then open a new terminal and sign in:

covdbg --version
covdbg login

Sign-in is team-scoped: in the browser you choose one team (your personal team, or a team you own or hold a seat in), and the agent's runs are licensed for that team. Use covdbg login --team to choose it up front, and covdbg whoami to see which team is active. In CI, COVDBGPROJECTTOKEN decides by the token's team.

Client setup

The server uses stdio transport. Start it from your project directory, or pass --workspace .

Claude Code

From the project directory:

claude mcp add covdbg -- covdbg mcp

Or add a project .mcp.json:

{
  "mcpServers": {
    "covdbg": {
      "command": "covdbg",
      "args": ["mcp"]
    }
  }
}

VS Code

.vscode/mcp.json:

{
  "servers": {
    "covdbg": {
      "type": "stdio",
      "command": "covdbg",
      "args": ["mcp", "--workspace", "${workspaceFolder}"]
    }
  }
}

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "covdbg": {
      "command": "covdbg",
      "args": ["mcp"]
    }
  }
}

Claude Desktop (MCP Bundle)

1. Download covdbg.mcpb from the latest release.
2. Open it with Claude Desktop, or drag it into Settings → Extensions.
3. Set the following:

• covdbg executable: the path to covdbg.exe. The default is the MSI install location.
• Workspace: your project directory.
• Project token: optional. Leave it empty if you have run covdbg login; runs are then licensed for the team you signed in to (see covdbg whoami).

The bundle does not contain covdbg itself. It launches your installed covdbg.exe, so covdbg updates take effect without a new bundle.

Tools

Shortened. The full README is on GitHub.