Skip to content
MCP server

MCP Debug Recorder

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

Runs locallyStatus and history
Install
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-mcp

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

How AIPoweredBot checks servers