MCP Debug Recorder MCP Server

Name: MCP Debug Recorder MCP Server
Author: io.github.oaslananka

io.github.oaslananka/debug-recorder-mcp

Repository Registry

What is the MCP Debug Recorder MCP server?

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

How to install MCP Debug Recorder

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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
secret
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.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "debug-recorder-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "debug-recorder-mcp"
      ],
      "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>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "debug-recorder-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "debug-recorder-mcp"
      ],
      "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>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "debug-recorder-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "debug-recorder-mcp"
      ],
      "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>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "debug-recorder-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "debug-recorder-mcp"
      ],
      "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>"
      }
    }
  }
}

Claude Code

claude mcp add debug-recorder-mcp --env DEBUG_RECORDER_DB=<YOUR_DEBUG_RECORDER_DB> --env LOG_LEVEL=<YOUR_LOG_LEVEL> --env FUZZY_THRESHOLD=<YOUR_FUZZY_THRESHOLD> --env DEBUG_RECORDER_REDACT_BEFORE_STORE=<YOUR_DEBUG_RECORDER_REDACT_BEFORE_STORE> --env HOST=<YOUR_HOST> --env PORT=<YOUR_PORT> --env DEBUG_RECORDER_HTTP_TOKEN=<YOUR_DEBUG_RECORDER_HTTP_TOKEN> --env DEBUG_RECORDER_ALLOWED_HOSTS=<YOUR_DEBUG_RECORDER_ALLOWED_HOSTS> --env DEBUG_RECORDER_ALLOWED_ORIGINS=<YOUR_DEBUG_RECORDER_ALLOWED_ORIGINS> --env DEBUG_RECORDER_MAX_BODY_BYTES=<YOUR_DEBUG_RECORDER_MAX_BODY_BYTES> --env DEBUG_RECORDER_REMOTE_HTTP=<YOUR_DEBUG_RECORDER_REMOTE_HTTP> -- npx -y debug-recorder-mcp