이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
debugmcp/mcp-debugger는 [[T0]에서 가져온 MCP 서버 후보입니다.
개요
debugmcp/mcp-debugger는 [[T0]에서 가져온 MCP 서버 후보입니다.
개요(AI 번역)
MCP 위의 헤드리스 에이전트 디버거 — AI 에이전트가 10개 언어로 실행 중인 프로그램을 디버깅할 수 있게 합니다.
🎯 개요
mcp-debugger는 단계별 디버깅을 구조화된 도구 호출로 노출하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 AI 에이전트가 브레이크포인트를 설정하고, 변수를 검사하며, 표현식을 평가하고, 10개 언어에 걸쳐 프로그램을 스텝스루 실행할 수 있게 해줍니다. 이는 Debug Adapter Protocol(DAP)을 통해 실제 언어 디버거를 구동합니다.
IDE가 필요 없습니다. mcp-debugger는 실행Node.js 어디서든 실행됩니다: CI 러너, Docker 컨테이너, Kubernetes 포드, SSH 박스, 그리고 클라우드 코딩 에이전트가 존재하는 샌드박스. IDE가 갈 수 없는 곳에서 디버거 역할을 합니다.
mcp-debugger를 사용할 때와 IDE에 바인딩된 디버그 서버 사용 시
마이크로소프트의 DebugMCP는 MCP 대신 VS Code의 디버거를 노출하며, 에이전트가 실행 중인 VS Code 내부에서 작동할 때 좋은 선택입니다. 두 프로젝트는 서로 다른 구조적 트레이드오프를 만듭니다:
| mcp-디버거 | microsoft/디버그MCP | |
|---|---|---|
| 헤드리스 실행(CI, 컨테이너, k8s, 클라우드 에이전트) | ✅ 독립 실행형 노드 프로세스 | ❌ 실행 중인 VS 코드 필요 |
| 전송 | stdio + 스트리밍 가능한 HTTP | 스트리밍 가능한 HTTP (localhost) |
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
mcp-debugger
A headless, agentic debugger over MCP — let your AI agents debug running programs in ten languages.
🎯 Overview
mcp-debugger is a Model Context Protocol (MCP) server that exposes step-through debugging as structured tool calls. It lets AI agents set breakpoints, inspect variables, evaluate expressions, and step through running programs across ten languages — driving real language debuggers through the Debug Adapter Protocol (DAP).
No IDE required. mcp-debugger runs anywhere Node.js runs: CI runners, Docker containers, Kubernetes pods, SSH boxes, and the sandboxes that cloud coding agents live in. It’s the debugger for where IDEs can’t go.
When to use mcp-debugger vs an IDE-bound debug server
Microsoft’s DebugMCP exposes VS Code’s debugger over MCP and is a good choice when your agent works inside a running VS Code. The two projects make different structural trade-offs:
| mcp-debugger | microsoft/DebugMCP | |
|---|---|---|
| Runs headless (CI, containers, k8s, cloud agents) | ✅ standalone Node process | ❌ requires a running VS Code |
| Transports | stdio + Streamable HTTP | Streamable HTTP (localhost) |
| Distribution | npx, npm, Docker image | VS Code Marketplace extension |
| Remote attach without an IDE | ✅ debugpy / rdbg / JDWP, incl. pods via port-forward | ❌ |
| Per-session process isolation | ✅ one proxy process per session | shares the VS Code instance |
Java hot-swap and Flutter hot reload (hot_reload) |
✅ | ❌ |
| Debuggee output as subscribable MCP resource | ✅ | ❌ |
| In-IDE debugging UX alongside the agent | ✅ read-only IDE mirror (expose_session) — the IDE joins the agent’s live session |
✅ native |
| Logpoints without pausing (prod-safe value watching) | ✅ logMessage breakpoints |
✅ via VS Code |
설치
docker run -i --rm -v $(pwd):/workspace debugmcp/mcp-debugger:latest설정
{
"mcpServers": {
"mcp-debugger": {
"command": "node",
"args": ["C:/path/to/mcp-debugger/dist/index.js", "stdio", "--log-level", "debug", "--log-file", "C:/path/to/logs/debug-mcp-server.log"],
"disabled": false,
"autoApprove": ["create_debug_session", "set_breakpoint", "get_variables"]
}
}
}