samefarrar/mcp-pdb

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

54 stars 18 forks 품질 64 트렌드 33

Repository Install

samefarrar/mcp-pdb는 https://github.com/samefarrar/mcp-pdb.에서 수입된 MCP 서버 후보입니다

개요

samefarrar/mcp-pdb는 https://github.com/samefarrar/mcp-pdb.에서 수입된 MCP 서버 후보입니다

개요(AI 번역)

MCP-PDB는 모델 Context Protocol (MCP)을 통해 Claude 및 기타 LLM을 사용하여 Python의 디버거 (pdb)를 사용하는 도구를 제공합니다. 이것은 python debugger에 코딩 에이전트 액세스를 제공함으로써 다양한 코딩 벤치 마크에 이익을 보여 마이크로 소프트에 의해 디버그 - gym에 의해 영감을 받았습니다.

⚠️ 보안 경고

이 도구는 디버거를 통해 Python 코드를 실행합니다. 신뢰할 수 있는 환경에서만 사용.

설치

uv와 잘 작동

Claude 코드

윈드 서핑

사용 가능한 도구

도구	설명
`start_debug(file_path, use_pytest, args)`	Python 파일의 로컬 디버깅 세션 시작
`connect_remote_debug(host, port, timeout)`	TCP에서 원격 PDB 세션에 연결
`send_pdb_command(command)`	PDB 인스턴스 실행 명령(현지 또는 원격)
`set_breakpoint(file_path, line_number)`	특정 라인의 휴식 포인트 설정
`clear_breakpoint(file_path, line_number)`	특선의 휴게소
[T5]	현재의 휴식 포인트 일람
`restart_debug()`	현재 디버깅 세션
`examine_variable(variable_name)`	가변에 대한 상세 정보를 얻으십시오

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

MCP-PDB: Python Debugger Interface for Claude/LLMs

MCP-PDB provides tools for using Python’s debugger (pdb) with Claude and other LLMs through the Model Context Protocol (MCP). This was inspired by debug-gym by Microsoft, which showed gains in various coding benchmarks by providing a coding agent access to a python debugger.

⚠️ Security Warning

This tool executes Python code through the debugger. Use in trusted environments only.

Installation

Works best with uv

Claude Code

# Install the MCP server
claude mcp add mcp-pdb -- uv run --with mcp-pdb mcp-pdb

# Alternative: Install with specific Python version
claude mcp add mcp-pdb -- uv run --python 3.13 --with mcp-pdb mcp-pdb

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

Windsurf

{
  "mcpServers": {
    "mcp-pdb": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-pdb",
        "mcp-pdb"
      ]
    }
  }
}

Available Tools

Tool	Description
`start_debug(file_path, use_pytest, args, caveman_mode)`	Start a local debugging session for a Python file
`connect_remote_debug(host, port, timeout, caveman_mode)`	Connect to a remote PDB session over TCP
`send_pdb_command(command, timeout)`	Send a command to the running PDB instance (local or remote)
`get_output(timeout)`	Wait for more output without sending a command (e.g. after a long `c`)
`interrupt()`	Pause a running local program, like Ctrl+C
`set_breakpoint(file_path, line_number, condition)`	Set a (optionally conditional) breakpoint
`clear_breakpoint(file_path, line_number)`	Clear the breakpoint(s) at a line
`list_breakpoints()`	List breakpoints in PDB and those tracked for restarts
`restart_debug()`	Restart/reconnect, restoring breakpoints and `caveman_mode`
`examine_variable(variable_name, include_attrs, max_chars)`	Type, length, value and attributes of an expression in one round-trip
`get_debug_status()`	Show the current state of the debugging session
`end_debug()`	End the session (kills the debuggee’s whole process group; closes the socket for remote)

How waiting works

Every command returns as soon as pdb prints its (Pdb) prompt, so ordinary commands come back in milliseconds. The timeout is only a ceiling (30 s for commands that run code such as c/r/unt, 10 s otherwise). If the program is still running when it expires, you get the partial output plus a note; call get_output to keep waiting or interrupt to pause it. Output that arrives between calls is never dropped — it is returned with the next response.

Breakpoints set with set_breakpoint or raw b ... commands are tracked

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "mcp-pdb": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-pdb",
        "mcp-pdb"
      ]
    }
  }
}