Python Debugger MCP

python调试器mcp:Claude/LLM的python调试器接口

python调试器mcp提供了通过模型上下文协议（mcp）将python的调试器（pdb）与Claude和其他LLM一起使用的工具。其灵感来源于 调试健身房 微软通过提供对python调试器的编码代理访问，在各种编码基准测试中取得了进展。

基于 mcp-pdb 具有显著增强功能：

中文文档

⚠️ 安全警告

此工具通过调试器执行Python代码。仅在受信任的环境中使用。

安装

配合使用效果最佳 紫外线

克劳德代码

# Install the MCP server directly from GitHub
claude mcp add python-debugger-mcp -- uv run --with git+https://github.com/Wangshengyang2004/python-debugger-mcp python-debugger-mcp

# Alternative: Install with specific Python version
claude mcp add python-debugger-mcp -- uv run --python 3.13 --with git+https://github.com/Wangshengyang2004/python-debugger-mcp python-debugger-mcp

# Note: The -- separator is required for Claude Code CLI

帆板运动

{
  "mcpServers": {
    "python-debugger-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/Wangshengyang2004/python-debugger-mcp",
        "python-debugger-mcp"
      ]
    }
  }
}

光标

方法1：使用mcp.json（推荐）

创建或编辑 ~/.cursor/mcp.json （全球）或 .cursor/mcp.json （项目特定）：

{
  "mcpServers": {
    "python-debugger-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/Wangshengyang2004/python-debugger-mcp",
        "python-debugger-mcp"
      ]
    }
  }
}

然后重新启动Cursor以加载MCP服务器。

方法2：一键安装

打开光标设置>MCP>单击“+添加MCP服务器”并粘贴：

uv run --with git+https://github.com/Wangshengyang2004/python-debugger-mcp python-debugger-mcp

开源代码

OpenCode基于VS Code架构构建，同样支持MCP服务器。

方法1：使用JSON设置

1. 打开命令面板（Ctrl+Shift+P）
2. 运行“首选项：打开设置（JSON）”
3. 添加以下配置：

{
  "mcpServers": {
    "python-debugger-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/Wangshengyang2004/python-debugger-mcp",
        "python-debugger-mcp"
      ]
    }
  }
}

方法2：使用.mcp.json文件

创建 ~/.opencode/mcp.json 对于全局设置：

{
  "mcpServers": {
    "python-debugger-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/Wangshengyang2004/python-debugger-mcp",
        "python-debugger-mcp"
      ]
    }
  }
}

然后重新启动OpenCode以应用更改。

可用工具

会话管理

执行控制

堆栈导航

断点

变量观察

代码检查

尸检调试

常见PDB命令

特性

• 具有自动虚拟环境检测功能的项目感知调试
• 支持直接Python调试和基于pytest的调试
• 会话之间的自动断点跟踪和恢复
• 与UV包管理器配合使用
• 具有类型信息和属性列表的变量检查
• 条件断点和临时断点
• 可变手表表情（显示）
• 烟囱导航和检查
• 死后调试支持

成功案例

调试2048游戏逻辑

使用python调试器mcp调试一个2048游戏项目，并成功发现并修复了一个错误：

发现Bug：In game.py，the _check_game_over() 当空单元格存在时，该方法很早就返回了，但忘记了设置 game_over = False。这导致游戏错误地报告“游戏结束”，即使有空单元格可用。

MCP如何提供帮助:

1. 使用设置断点 set_breakpoint() 检查游戏状态
2. 使用以下代码逐步完成 send_pdb_command("n")
3. 检查以下变量 game.board 和 examine_variable()
4. 使用清除和管理断点 clear_breakpoint()
5. 验证修复是否正常工作

结果：修复了错误-现在可以正确检测游戏结束状态。

故障排除

Claude代码安装问题

如果您遇到以下错误：

MCP server "python-debugger-mcp" Connection failed: spawn /Users/xxx/.local/bin/uv run --python 3.13 --with python-debugger-mcp python-debugger-mcp ENOENT

确保包括 -- 使用时使用分离器 claude mcp add:

# ✅ Correct
claude mcp add python-debugger-mcp -- uv run --with git+https://github.com/Wangshengyang2004/python-debugger-mcp python-debugger-mcp

# ❌ Incorrect (missing --)
claude mcp add python-debugger-mcp uv run --with git+https://github.com/Wangshengyang2004/python-debugger-mcp python-debugger-mcp

要验证您的安装：

# Check if python-debugger-mcp is listed
claude mcp list | grep python-debugger-mcp

# Check server status in Claude Code
# Type /mcp in Claude Code to see connection status

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

致谢

• 原始项目： mcp-pdb 作者：丹尼尔·加夫尼
• 灵感源自 调试健身房 微软