Metadata-Version: 2.4
Name: debugger-mcp
Version: 0.1.0
Summary: MCP server exposing debugger tools for AI clients (Node.js and Python)
Project-URL: Source, https://github.com/your-org/top-coder-agent-skills
Project-URL: Documentation, https://github.com/your-org/top-coder-agent-skills#readme
License-Expression: MIT
Keywords: ai,cdp,cursor,dap,debugger,mcp
Requires-Python: >=3.11
Requires-Dist: mcp
Requires-Dist: top-coder-ai-skills-debugger
Description-Content-Type: text/markdown

# debugger-mcp

MCP server that exposes **debugger tools** to AI clients (Cursor, Claude Code, etc.): launch, breakpoints, continue, step, evaluate, stack, variables, probe, stop. Supports **Node.js** (CDP) and **Python** (DAP). The debugger runtime ([top-coder-ai-skills-debugger](https://pypi.org/project/top-coder-ai-skills-debugger/)) is included as a dependency — **no separate installation**.

## Install

One install is enough (the debugger library is pulled in automatically):

```bash
pip install debugger-mcp
# or
uv add debugger-mcp
# or
poetry add debugger-mcp
```

**Requires:** Python ≥3.11. Nothing else to install.

### Global

Use without adding the package to a project:

- **pipx** (install once, run from anywhere):
  ```bash
  pipx install debugger-mcp
  debugger-mcp
  ```
  Then in MCP config use `"command": "debugger-mcp"` (pipx puts it on PATH).

- **uvx** (run on demand, no install — like `npx`):
  ```bash
  uvx debugger-mcp
  ```
  In MCP config: `"command": "uvx", "args": ["debugger-mcp"]`.

## Run

Stdio transport (e.g. for Cursor MCP):

```bash
python -m debugger_mcp
```

Configure in your MCP client (e.g. Cursor) as:

```json
{
  "mcpServers": {
    "debugger": {
      "command": "python3",
      "args": ["-m", "debugger_mcp"]
    }
  }
}
```

Ensure the `python3` (or `uv run`) environment has `debugger-mcp` installed so that `python -m debugger_mcp` works.

## Tools

| Tool | Description |
|------|-------------|
| `debug_launch` | Start debugging a program (program, language) |
| `debug_breakpoint` | Set breakpoint (file, line) |
| `debug_continue` | Resume until next breakpoint or exit |
| `debug_step` | Step over or step in |
| `debug_evaluate` | Evaluate expression in current frame |
| `debug_stack` | Get call stack |
| `debug_variables` | Get local variables |
| `debug_probe` | One-shot: run to line, dump state, stop |
| `debug_stop` | End the debug session |

See the repo and [ARCHITECTURE.md](ARCHITECTURE.md) for protocol and usage details.
