Debug Recorder MCP Server

by oaslanankaio.github.oaslananka/debug-recorder-mcpv1.1.3

Record debug sessions, commands, failed attempts, and successful fixes in local SQLite storage.

2Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active3d ago

Install Debug Recorder MCP server

claude mcp add debug-recorder -e DEBUG_RECORDER_HTTP_TOKEN='<debug-recorder-http-token>' -- npx -y debug-recorder-mcp

{
  "mcpServers": {
    "debug-recorder": {
      "command": "npx",
      "args": [
        "-y",
        "debug-recorder-mcp"
      ],
      "env": {
        "DEBUG_RECORDER_HTTP_TOKEN": "<debug-recorder-http-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "debug-recorder": {
      "command": "npx",
      "args": [
        "-y",
        "debug-recorder-mcp"
      ],
      "env": {
        "DEBUG_RECORDER_HTTP_TOKEN": "<debug-recorder-http-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "debug-recorder": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "debug-recorder-mcp"
      ],
      "env": {
        "DEBUG_RECORDER_HTTP_TOKEN": "<debug-recorder-http-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "debug-recorder": {
      "command": "npx",
      "args": [
        "-y",
        "debug-recorder-mcp"
      ],
      "env": {
        "DEBUG_RECORDER_HTTP_TOKEN": "<debug-recorder-http-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
DEBUG_RECORDER_DB	—	—	Override the SQLite database location for local debug history.
LOG_LEVEL	—	—	Set the minimum structured log level: debug, info, warn, or error.
FUZZY_THRESHOLD	—	—	Override the Fuse.js threshold used during fuzzy reranking.
DEBUG_RECORDER_REDACT_BEFORE_STORE	—	—	Set to true to redact common secret patterns before persisting debug text.
HOST	—	—	HTTP bind host for optional Streamable HTTP mode. Defaults to 127.0.0.1.
PORT	—	—	HTTP port for optional Streamable HTTP mode.
DEBUG_RECORDER_HTTP_TOKEN	—	yes	Bearer token for optional Streamable HTTP mode. Required for non-loopback bind.
DEBUG_RECORDER_ALLOWED_HOSTS	—	—	Comma-separated HTTP Host allowlist for optional Streamable HTTP mode.
DEBUG_RECORDER_ALLOWED_ORIGINS	—	—	Comma-separated Origin allowlist for optional Streamable HTTP mode.
DEBUG_RECORDER_MAX_BODY_BYTES	—	—	Maximum JSON body size for optional Streamable HTTP mode.
DEBUG_RECORDER_REMOTE_HTTP	—	—	Must be true to allow optional Streamable HTTP mode to bind outside loopback.

Freshness

Active — last maintenance signal 3d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-07 · 3d ago · GitHub
Latest release
2026-07-21 · 3mo ago · GitHub · debug-recorder-mcp-v1.1.3
Package published
no data · npm/PyPI
Registry entry updated
2026-07-21 · 3mo ago · official registry · v1.1.3

FAQ

›How do I install the Debug Recorder MCP server in Claude Code?

Run: claude mcp add debug-recorder -e DEBUG_RECORDER_HTTP_TOKEN='<debug-recorder-http-token>' -- npx -y debug-recorder-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Debug Recorder require an API key?

Yes. It expects DEBUG_RECORDER_HTTP_TOKEN, of which 1 is a secret.

›Can I use Debug Recorder as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Debug Recorder in the official MCP registry?

Yes, as io.github.oaslananka/debug-recorder-mcp.