covdbg
Measure C++ code coverage on Windows from PDBs and find uncovered code, no rebuild
- Pricing
- Freemium
- Platforms
- Windows, CLI, vscode
- Runs
- Locally
- Version
- 1.5.1
- Listing updated
- 3 days ago
About covdbg
covdbg is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.
covdbg behaves like a debugger: it starts an existing executable, reads its PDB and places lightweight probes while it runs, so no recompilation is needed. It handles x64, ARM64 and 32-bit x86 binaries. The MCP server is built into the covdbg executable and started with covdbg mcp, speaking stdio.
The workflow is a loop. The agent reads a guide, discovers executables and coverage databases, starts a run, waits for it, ranks files by uncovered lines and reads the uncovered segments with context. It then edits tests with its own tools and measures again. The server does not write source or tests itself. It can also run read-only SQL over .covdbg databases and merge them.
Runs need Windows, a PDB, a .covdbg.yaml and a sign-in via covdbg login or a project token in CI. Public GitHub Actions repos need no token. Pricing is free for personal and open-source use with one private repository, and $12 per user per month for teams.
Install
Run in a terminal
claude mcp add covdbg --env COVDBG_PROJECT_TOKEN='<COVDBG_PROJECT_TOKEN>' -- npx -y https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"covdbg": {
"command": "npx",
"args": [
"-y",
"https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb"
],
"env": {
"COVDBG_PROJECT_TOKEN": "<COVDBG_PROJECT_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"covdbg": {
"command": "npx",
"args": [
"-y",
"https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb"
],
"env": {
"COVDBG_PROJECT_TOKEN": "<COVDBG_PROJECT_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"covdbg": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb"
],
"env": {
"COVDBG_PROJECT_TOKEN": "<COVDBG_PROJECT_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"covdbg": {
"command": "npx",
"args": [
"-y",
"https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb"
],
"env": {
"COVDBG_PROJECT_TOKEN": "<COVDBG_PROJECT_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"covdbg": {
"command": "npx",
"args": [
"-y",
"https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb"
],
"env": {
"COVDBG_PROJECT_TOKEN": "<COVDBG_PROJECT_TOKEN>"
}
}
}
}Configuration
COVDBG_PROJECT_TOKENProject token for CI or headless use. Not needed after `covdbg login`.COVDBG_OUTPUTFixed default output location for coverage databases.
Tools this server provides (11)
Taken from the project documentation; the running server may differ.
- guide
- Reads workflow and configuration guidance.
- discover
- Finds executables and coverage databases.
- run
- Starts a coverage run.
- wait_run
- Waits briefly or collects the result.
- cancel_run
- Terminates a run.
- open_coverage
- Opens an existing database read-only.
- files
- Ranks files by uncovered lines.
- code
- Reads uncovered source with context.
- query
- Runs one read-only SQL statement.
- merge
- Combines databases.
- close
- Releases a session.
What it does
- No-rebuild coverage
- Probes binaries via their PDBs while they run.
- Uncovered-code ranking
- Rank files by uncovered lines and read segments.
- SQL queries
- Run read-only SQL over coverage databases.
- Merge databases
- Combine coverage across checkouts and builds.
- Guide tool
- Built-in workflow and configuration topics.
- CI friendly
- Project token or GitHub Actions identity for public repos.
Good for
- Have an agent add tests for uncovered Windows C++ code
- Find dead code with SQL against coverage data
- Merge coverage across several test binaries
- Measure coverage improvement after new tests
Pricing
Freemium, from $12 a month
Free for personal and open source (one private repo); Team $12 per user per month
Prices change. Check covdbg.com before you buy.
covdbg FAQ
What platform does it need?
Windows x64 or ARM64 with PDB debug symbols.
What does it cost?
Free for personal use and open source; Team is $12 per user per month.
Does it edit tests?
No, it supplies measurements and context; the agent edits.
Does it send my code anywhere?
The pricing page says it never sends source code, file names, paths or coverage data.
Is covdbg free?
covdbg has a free plan, with paid plans for more usage or features. Paid plans start at $12 a month.
How do I add covdbg to Claude Code?
Run this command in your terminal: claude mcp add covdbg --env COVDBG_PROJECT_TOKEN='<COVDBG_PROJECT_TOKEN>' -- npx -y https://github.com/liasoft/covdbg-mcp/releases/download/v1.5.1/covdbg.mcpb
What are the best alternatives to covdbg?
The closest alternatives to covdbg are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to covdbg

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools