pdb-mcp

# PDB MCP Server [](https://badge.fury.io/py/pdb-mcp) [](https://opensource.org/licenses/MIT) A Model Context Protocol (MCP) server for Python debugging using pdb. This allows you to debug Python scripts through MCP tools. ## Features - **Start Debug Session**: Launch a Python script in debug mode using pdb - **Start Pytest Debug Session**: Run pytest with automatic pdb on test failures - **Execute PDB Commands**: Send commands to control the debugging session - **Auto-detect Python Interpreter**: Automatically uses virtual environment Python - **Modular Architecture**: Clean separation of concerns with session and server modules ## Installation ### Install from PyPI ```bash pip install pdb-mcp ``` ### Install with uv (Recommended) ⚡️ [`uvx`](https://docs.astral.sh/uv/concepts/tools/) will automatically install the package and run the command. ```bash uvx pdb-mcp ``` ### Development Installation ```bash pip install -e . ``` ## Usage ### As MCP Server Run the server: ```bash pdb-mcp ``` The server exposes three tools: #### 1. `start_debug` Start a debugging session for a Python script. **Parameters:** - `script_path` (required): Path to the Python script to debug - `python_path` (required): Path to Python interpreter for the project being debugged - `working_directory` (required): Directory to run the command in (should be the project directory) - `args` (optional): Command-line arguments to pass to the script - `timeout` (optional): Time to wait without new output before returning in seconds (default: 5.0). As long as there's new output, will keep waiting. - `env` (optional): Environment variables to set for the debugging session (e.g., {"DEBUG": "1"}) **Example:** ```json { "script_path": "test_script.py", "python_path": "/path/to/python", "working_directory": "/path/to/project", "env": {"DEBUG": "1"} } ``` #### 2. …