What is cpp-debug-mcp CLAUDE.md?

A project guide for Claude Code working on a C++ debugging server. It describes the repository structure, development setup, testing commands, and components that connect the GNU Debugger and clangd, a C++ code-analysis tool.

It is for developing and testing a Python server that exposes C++ debugging and code-analysis tools.

It gives the coding agent the project-specific context needed to navigate the codebase and use its setup and test commands correctly.

How William-An/cpp-debug-mcp configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to William-An/cpp-debug-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/William-An/cpp-debug-mcp/master/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/William-An/cpp-debug-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/william-an/cpp-debug-mcp/claude-md/github.svg)](https://agentmods.dev/instructions/william-an/cpp-debug-mcp/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/william-an/cpp-debug-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/william-an/cpp-debug-mcp/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/william-an/cpp-debug-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/william-an/cpp-debug-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 786 This file is loaded in full into every session.

When invoked 786 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00786	$0.00786
Opus 5.5	$0.00314	$0.00314
Sonnet 5.5	$0.00157	$0.00157
Haiku 4.5	$0.00079	$0.00079

Measured 2mo ago against content hash 971bb2df0ffb, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

cpp-debug-mcp CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 78 lines

How it starts

The opening of the file, as written. The whole thing — 78 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md — cpp-debug-mcp

Project Overview

MCP server plugin for Claude Code that integrates GDB (via GDB/MI) and clangd (via LSP) for C++ debugging. Published on PyPI as cpp-debug-mcp.

Repository Layout

src/cpp_debug_mcp/
  server.py          — FastMCP server entry point, lifespan, tool registration
  __main__.py         — python -m entry point
  gdb/
    controller.py     — Async GDB/MI wrapper (pygdbmi + run_in_executor)
    session.py        — Session lifecycle, tmux console management
  lsp/
    client.py         — Async JSON-RPC client for clangd over STDIO
    protocol.py       — LSP message helpers & response parsers
    session.py        — clangd session manager
  analysis/
    correlator.py     — Cross-references GDB runtime + LSP static info
  tools/
    fmt.py            — Human-readable output formatting
    gdb_tools.py      — 16 GDB MCP tools
    lsp_tools.py      — 8 LSP MCP tools
    combined_tools.py — 3 combined GDB+LSP tools
tests/               — pytest tests (fixtures in tests/fixtures/)

Development Setup

uv venv .venv
source .venv/bin/activate
uv pip install -e ".[dev]"
pytest tests/ -v

Testing

27 tests currently pass; 10 are skipped when clangd is not installed
Tests require gdb to be installed (system package)
Test fixtures: tests/fixtures/sample.cpp (valid program), tests/fixtures/segfault.cpp (null deref)
Fixtures are compiled automatically by tests via the Makefile

Release & Publish Flow

Bump version in both pyproject.toml and setup.cfg (they must stay in sync)
Commit and push to master
Create a GitHub release: gh release create v<VERSION> --title "v<VERSION>" --notes "..."
The .github/workflows/publish.yml workflow runs tests on Python 3.10/3.12/3.13, then publishes to PyPI via trusted publisher (OIDC — no API tokens needed)
PyPI indexing takes ~30 seconds; verify with pip index versions cpp-debug-mcp

MCP Registration

Global (all projects):

claude mcp add --scope user cpp-debug -- uvx cpp-debug-mcp

Read the full file on GitHub · 78 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 78 lines · 786 tokens per session scan A 971bb2df0ffb

Subscribe to this mod's changes

cpp-debug-mcp CLAUDE.md is an instructions file published in the GitHub repository William-An/cpp-debug-mcp (1 stars, last pushed 7mo ago), licensed MIT. It adds 786 tokens to every session, about $0.0031 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Debugging

cpp-debug-mcp CLAUDE.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
cpp-debug-mcp CLAUDE.mdWilliam-An/cpp-debug-mcp	Instructions file	1	7mo ago	MIT	A	786	Claude Code
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	9,719	GitHub Copilot
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	5,516	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	today	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	today	MIT	A	4,680	Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	3,093	GitHub Copilot
vscode model-prompts.instructions.mdmicrosoft/vscode	Instructions file	195k	today	MIT	A	2,022	GitHub Copilot

cpp-debug-mcp: Instructions file for Claude Code