MCP Debug Recorder
Record debug sessions, commands, failed attempts, and successful fixes in local SQLite…
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.1.3
- Listing updated
- 6 days ago
About MCP Debug Recorder
MCP Debug Recorder is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Record debug sessions, commands, failed attempts, and successful fixes in local SQLite storage.
Install
Run in a terminal
claude mcp add debug-recorder-mcp --env DEBUG_RECORDER_HTTP_TOKEN='<DEBUG_RECORDER_HTTP_TOKEN>' -- npx -y debug-recorder-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"debug-recorder-mcp": {
"command": "npx",
"args": [
"-y",
"debug-recorder-mcp"
],
"env": {
"DEBUG_RECORDER_HTTP_TOKEN": "<DEBUG_RECORDER_HTTP_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"debug-recorder-mcp": {
"command": "npx",
"args": [
"-y",
"debug-recorder-mcp"
],
"env": {
"DEBUG_RECORDER_HTTP_TOKEN": "<DEBUG_RECORDER_HTTP_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"debug-recorder-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"debug-recorder-mcp"
],
"env": {
"DEBUG_RECORDER_HTTP_TOKEN": "<DEBUG_RECORDER_HTTP_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"debug-recorder-mcp": {
"command": "npx",
"args": [
"-y",
"debug-recorder-mcp"
],
"env": {
"DEBUG_RECORDER_HTTP_TOKEN": "<DEBUG_RECORDER_HTTP_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"debug-recorder-mcp": {
"command": "npx",
"args": [
"-y",
"debug-recorder-mcp"
],
"env": {
"DEBUG_RECORDER_HTTP_TOKEN": "<DEBUG_RECORDER_HTTP_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
DEBUG_RECORDER_DBOverride the SQLite database location for local debug history.LOG_LEVELSet the minimum structured log level: debug, info, warn, or error.FUZZY_THRESHOLDOverride the Fuse.js threshold used during fuzzy reranking.DEBUG_RECORDER_REDACT_BEFORE_STORESet to true to redact common secret patterns before persisting debug text.HOSTHTTP bind host for optional Streamable HTTP mode. Defaults to 127.0.0.1.PORTHTTP port for optional Streamable HTTP mode.DEBUG_RECORDER_HTTP_TOKENBearer token for optional Streamable HTTP mode. Required for non-loopback bind.DEBUG_RECORDER_ALLOWED_HOSTSComma-separated HTTP Host allowlist for optional Streamable HTTP mode.DEBUG_RECORDER_ALLOWED_ORIGINSComma-separated Origin allowlist for optional Streamable HTTP mode.DEBUG_RECORDER_MAX_BODY_BYTESMaximum JSON body size for optional Streamable HTTP mode.DEBUG_RECORDER_REMOTE_HTTPMust be true to allow optional Streamable HTTP mode to bind outside loopback.
Pricing
Open source
MCP Debug Recorder FAQ
Is MCP Debug Recorder free?
Yes. MCP Debug Recorder is open source, so you can use and self-host it for free.
How do I add MCP Debug Recorder to Claude Code?
Run this command in your terminal: claude mcp add debug-recorder-mcp --env DEBUG_RECORDER_HTTP_TOKEN='<DEBUG_RECORDER_HTTP_TOKEN>' -- npx -y debug-recorder-mcp
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.