DebugMCP CLI is now available on npm

[Oz Zafar (ozzafar)]

Debug directly from the terminal

We are excited to announce the standalone DebugMCP CLI, now available on npm.

DebugMCP CLI lets MCP-compatible AI coding agents control explicitly configured Debug Adapter Protocol (DAP) adapters without requiring VS Code or any IDE at all. The debug adapter and target process run in the background while your AI agent controls the debugging session directly from the terminal. It keeps debugging local and gives agents the same core workflow: set breakpoints, launch targets, step through execution, inspect variables, and evaluate expressions.

Install

npm install --global debugmcp
debugmcp configure --agent copilot-cli

Restart the configured agent after setup.

Register a debugger

DebugMCP never discovers, downloads, or upgrades debugger adapters automatically. Register the adapter supplied by your environment. For Python:

python -m pip install debugpy
debugmcp adapter add python --command "python -m debugpy.adapter"
debugmcp adapter validate python

The CLI supports any language with a DAP adapter that communicates over stdio. It includes convenience registration shorthands for Python, C#/.NET, C/C++, JavaScript/TypeScript/Node.js, Java, Go, Rust, Ruby, PHP, Swift, and Dart; languages not listed use explicit --type and --extensions registration.

Highlights

• Runs as a local MCP server over stdio
• Works without VS Code
• Supports any language with a DAP adapter that communicates over stdio
• Configures GitHub Copilot CLI and other supported MCP agents
• Ships the debug-live root-cause debugging workflow
• Keeps project adapter configuration in .debugmcp.json

📦 View debugmcp on npm

📖 Read the standalone CLI documentation

Feedback, adapter recipes, and bug reports are welcome in this Discussion and in GitHub Issues.

[ankitajha6475-jpg]

Great work, highly underrated.