Skip to content
MCP server

covdbg

Measure C++ code coverage on Windows from PDBs and find uncovered code, no rebuild

Runs locallyStatus and history
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.mcpb

Add 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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools