MCP Debug Recorder
Officialby oaslananka · TypeScript
Record debug sessions, commands, failed attempts, and successful fixes in local SQLite storage.
Record debug sessions, commands, failed attempts, and successful fixes in local SQLite storage.
Topics
README not available yet.
Install
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_TOKENsecretBearer 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.
claude_desktop_config.json
{
"mcpServers": {
"debug-recorder-mcp": {
"command": "npx",
"args": [
"-y",
"debug-recorder-mcp@1.1.0"
],
"env": {
"DEBUG_RECORDER_DB": "<YOUR_DEBUG_RECORDER_DB>",
"LOG_LEVEL": "<YOUR_LOG_LEVEL>",
"FUZZY_THRESHOLD": "<YOUR_FUZZY_THRESHOLD>",
"DEBUG_RECORDER_REDACT_BEFORE_STORE": "<YOUR_DEBUG_RECORDER_REDACT_BEFORE_STORE>",
"HOST": "<YOUR_HOST>",
"PORT": "<YOUR_PORT>",
"DEBUG_RECORDER_HTTP_TOKEN": "<YOUR_DEBUG_RECORDER_HTTP_TOKEN>",
"DEBUG_RECORDER_ALLOWED_HOSTS": "<YOUR_DEBUG_RECORDER_ALLOWED_HOSTS>",
"DEBUG_RECORDER_ALLOWED_ORIGINS": "<YOUR_DEBUG_RECORDER_ALLOWED_ORIGINS>",
"DEBUG_RECORDER_MAX_BODY_BYTES": "<YOUR_DEBUG_RECORDER_MAX_BODY_BYTES>",
"DEBUG_RECORDER_REMOTE_HTTP": "<YOUR_DEBUG_RECORDER_REMOTE_HTTP>"
}
}
}
}