Transparent proxy to debug, record, validate, and replay MCP (Model Context Protocol) sessions
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-debugger","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# mcp-debugger > Transparent proxy to **debug, record, validate, and replay** MCP (Model Context Protocol) sessions.  [](https://pypi.org/project/mcp-debugger/) [](https://github.com/sushant-mutnale/mcp-debugger/actions/workflows/ci.yml) [](https://pypi.org/project/mcp-debugger/) [](https://opensource.org/licenses/MIT) [](https://github.com/sushant-mutnale/mcp-debugger/actions) --- ## ✨ Features | Feature | What it does | |---|---| | 🔍 **Record** | Capture every JSON-RPC message between an MCP client and server | | 📋 **Inspect** | Browse messages with syntax-highlighted, formatted terminal output | | ✅ **Validate** | Check MCP protocol compliance — handshake order, method names, schemas | | 🔄 **Replay** | Regression-test server changes by replaying recorded sessions | | 📊 **Stats** | Visualise tool usage, latency trends, and error rates | | 🔀 **Compare** | Delta reports between two sessions (latency, errors, tool calls) | | 📤 **Export** | JSON, Markdown, or OpenTelemetry (OTLP) traces | | ⚙️ **Config** | Persistent user preferences — aliases, timeouts, defaults | | 🩺 **Doctor** | Environment diagnostics — Python version, SQLite, Node.js, paths | | 🚀 **Local-first** | No cloud, no signup — all data stays on your machine | --- ## 📦 Installation ```bash pip install mcp-debugger ``` With optional OpenTelemetry (OTLP) export support: ```bash pip install "mcp-debugger[otlp]" ``` **Requirements:** Python 3.11+, Node.js (for `npx`-based MCP servers) --- ## 🚀 Quickstart ### 1. Record a session ```bash mcp-debugger proxy \ --server "npx -y @modelcontextprot…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.