hwanyong/mcp-debug-tools
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
MCP 기반 디버깅을 위한 VSCode 확장 및 CLI 도구
개요
- AI Assistant 설정 Breakpoints, 코드를 통해 단계, 실시간 변수를 검사합니다. 전통적인 AI 코딩 조수와 코드, 하지만 그들은 그것을 할 수 없습니다. MCP Debug Tools는 간단한 CLI 명령을 통해 VS Code의 디버거에 직접 액세스를 제공함으로써이 제한을 제거합니다. 표준 MCP 프록시를 넘어, 를 통해 디버깅 작업을 실행할 수 있습니다. — no persistent connection required. - : Shell-based AI Agent는 debugger와 직접 상호 작용합니다. : MCP 서버 연결을 구성하거나 유지해야 할 필요가 없습니다. : 순수 JSON (stdout)의 결과, stderr로 분리 된 로그 - AI parses 즉시 - : 자동화 된 bash 스크립트에 통합 활성화 될 때 작업 공간에 확장, 그래서 AI 에이전트 발견 하 고 디버깅 도구를 사용할 수 있습니다. VS Code Extension의 설치 경로에서 CLI를 직접 실행 — . 모든 것은 이제 완전히 auto-injected 기술 파일에 문서화, 매개 변수와 사용 예제 카테고리로 구성. 현재 베타 테스트.
개요(AI 번역)
**AI Agents와 VS Code Debugger 사이의 교량 ** - AI Assistant 설정 Breakpoints, 코드를 통해 단계, 실시간 변수를 검사하십시오.
왜 MCP 디버그 도구?
전통적인 AI 코딩 조수는 ** 읽을 수 있습니다 ** 및 ** write ** 코드, 그러나 그들은 ** 디버그 ** 그것을 할 수 없습니다. MCP Debug Tools는 간단한 CLI 명령을 통해 VS Code의 디버거에 직접 액세스를 제공함으로써이 제한을 제거합니다.
| MCP 디버그 도구없이 | MCP 디버그 도구 |
|---|---|
| 코드 읽기에서 버그에 대한 AI 추측 | AI 세트 Breakpoints and inspects live runtime state |
| 「 콘솔을 추가해 주세요」 | 코드를 통해 AI 단계별 자동 |
| 오류 메시지의 수동 복사 방지 | AI는 JSON으로 통화 스택과 변수 값을 읽습니다 |
✅ 직접 CLI 제어 — MCP 연결 없이 작동
표준 MCP 프록시를 넘어 ** One-off 터미널 명령**을 통해 디버깅 작업을 실행할 수 있습니다.
- Terminal AI Friendly: Shell 기반 AI 에이전트는 디버거와 직접 상호 작용합니다.
- **Zero 연결 오버헤드 **: MCP 서버 연결을 구성하거나 유지할 필요가 없습니다
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
MCP Debug Tools
The bridge between AI Agents and VS Code Debugger — Let your AI assistant set breakpoints, step through code, and inspect variables in real-time.
Why MCP Debug Tools?
Traditional AI coding assistants can read and write code, but they can’t debug it. MCP Debug Tools removes this limitation by giving AI agents direct access to VS Code’s debugger through simple CLI commands.
| Without MCP Debug Tools | With MCP Debug Tools |
|---|---|
| AI guesses at bugs from code reading | AI sets breakpoints and inspects live runtime state |
| “Try adding a console.log here” | AI steps through code line-by-line automatically |
| Manual copy-paste of error messages | AI reads call stacks and variable values as JSON |
💡 Direct CLI Control — Works Without MCP Connection
Beyond the standard MCP proxy, you can execute debugging actions via one-off terminal commands — no persistent connection required.
- Terminal AI Friendly: Shell-based AI agents interact with the debugger directly
- Zero Connection Overhead: No need to configure or maintain an MCP server connection
- Easy Parsing: Results in pure JSON (
stdout), logs separated tostderr— AI parses instantly - Scriptable: Integrate VS Code debugging into automated bash scripts seamlessly
# Discover all available tools
npx @uhd_kr/mcp-debug-tools list
# Execute tools directly
npx @uhd_kr/mcp-debug-tools call add-breakpoint '{"file": "src/app.ts", "line": 15}'
npx @uhd_kr/mcp-debug-tools call step-over
🚀 What’s New in v1.0.0
🤖 AI Agent Skill Auto-Injection
The extension now automatically injects skill documents into your workspace when activated, so AI agents can discover and use debugging tools without any manual configuration.
| AI Platform | Auto-detected Path | Status |
|---|---|---|
| Gemini (Google) | .gemini/skills/dap-cli-debugging/SKILL.md |
✅ Supported |
| Claude Code (Anthropic) | .claude/skills/dap-cli-debugging/SKILL.md |
✅ Supported |
🔌 Offline CLI Support
Run the CLI directly from the VS Code extension’s install path — no internet or npx required.
# macOS / Linux
node ~/.vscode/extensions/uhd.mcp-debug-tools-*/out/cli.js call get-active-session
# Windows (PowerShell)
node "$env:USERPROFILE\.vscode\extensions\uhd.mcp-debug-tools-*\out\cli.js" call get-active-session
📖 Comprehensive Tool Documentation
All 29 debugging tools are now fully documented in the auto-injected skill file, organized by category with parameters and usage examples.
⚠️ Beta Testing
설치
npx -y @uhd_kr/mcp-debug-tools@latest설정
{
"mcpServers": {
"dap-proxy": {
"command": "npx",
"args": ["-y", "@uhd_kr/mcp-debug-tools@latest"],
"env": {}
}
}
}