hwanyong/mcp-debug-tools
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
DAPプロトコル対応でMCPベースのデバッグ用のVSCode拡張とCLIツール
概要
— AIアシスタントがブレイクポイントを設定し、コードを経由して、リアルタイムで変数を検査します。 従来のAIコーディングアシスタントは、コードやコードをすることができますが、コード化できません。 MCP Debug Tools は、シンプルな CLI コマンドで、VS コードのデバッガに直接アクセスすることで、この制限を解除します。 標準のMCPプロキシを超えて、永続的な接続は必要ありません。 - : Shell ベースの AI エージェントは、直接デバッガーとやり取りします。 : MCP サーバー接続の設定やメンテナンスは必要ありません。 : 純粋な JSON (stdout) で、ログは stderr に分離します。 AI は即座に解析します。 : VS コードのデバッグを自動化したバッススクリプトにシームレスに統合します。 作業スペースに拡張できるので、AIエージェントはデバッギングツールを発見して利用することができます。 VS コード拡張のインストールパスから直接CLIを実行します。 これで、パラメータと使用例のカテゴリで整理された自動注入されたスキルファイルで完全に文書化されます。 現在ベータテスト中です.
概要（AI 翻訳）
AIエージェントとVSコードデバッガー間のブリッジ — AIアシスタントがブレークポイントを設定し、コードを経由して、リアルタイムで変数を検査します。
#MCPデバッグツールの理由
従来のAIコーディングアシスタントはreadとwriteのコードを使用できますが、デバッグ**はできません。 MCP Debug Tools は、シンプルな CLI コマンドで、VS コードのデバッガに直接アクセスすることで、この制限を解除します。
| MCP デバッグツールなし | MCP デバッグツール付き | |--------------------------------------------| | AIはコード読み取りからバグを推測 | ライブランタイム状態を把握・検査 | | 「コンソールを追加」 | コードライン別自動でAIステップ | | エラーメッセージの手動コピーペースト | JSON でコールスタックや変数値を読み込む |
◀ 直接 CLI 制御 — MCP 接続なしで動作します。
標準の MCP プロキシを超えて、one-off ターミナルコマンドでデバッグ操作を実行できます — 永続接続は必要ありません。
- 末端AIフレンドリー:シェルベースのAIエージェントは、直接デバッガと対話
- ゼロ関係の頭上: 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": {}
}
}
}