agentic-debugger
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@agentic-debugger add logging to line 42 in cart.js to see why total is NaN"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
agentic-debugger
An MCP (Model Context Protocol) server that enables interactive debugging with code instrumentation for AI coding assistants. Inspired by Cursor's debug mode.
Works with any MCP-compatible AI coding tool:
Claude Code
Cursor
Windsurf
Cline
GitHub Copilot
Kiro
Zed
And more...
Features
Live code instrumentation - Inject debug logging at specific lines
Variable capture - Log variable values at runtime
Multi-language support - JavaScript, TypeScript, and Python
Browser support - CORS-enabled for browser JS debugging
Clean removal - Region markers ensure instruments are fully removed
Related MCP server: VSCode Debug MCP
Installation
Using npx (recommended)
Add to your MCP configuration:
{
"mcpServers": {
"debug": {
"command": "npx",
"args": ["-y", "agentic-debugger"]
}
}
}Configuration file locations:
Claude Code:
~/.mcp.jsonCursor:
.cursor/mcp.jsonin your project or~/.cursor/mcp.jsonOther tools: Check your tool's MCP documentation
Global install
npm install -g agentic-debuggerThen configure:
{
"mcpServers": {
"debug": {
"command": "agentic-debugger"
}
}
}Available Tools
Tool | Description |
| Start HTTP server for log collection |
| Stop server and cleanup |
| Insert logging code at file:line |
| Remove debug code from file(s) |
| Show all active instruments |
| Read captured log data |
| Clear the log file |
How It Works
Start session - Spawns a local HTTP server (default port 9876)
Add instruments - Injects
fetch()calls that POST to the serverReproduce bug - Run your code, instruments capture variable values
Analyze logs - Read the captured data to identify issues
Cleanup - Remove all instruments and stop the server
Debug Workflow Example
You: "Help me debug why the total is NaN"
AI Assistant:
1. Starts debug session
2. Reads your code to understand the logic
3. Adds instruments at suspicious locations
4. "Please run your code to reproduce the issue"
You: *runs code* "Done"
AI Assistant:
5. Reads debug logs
6. "I see `discount` is undefined at line 15..."
7. Removes instruments
8. Fixes the bug
9. Stops debug sessionInstrument Examples
JavaScript/TypeScript
// #region agentic-debug-abc123
fetch('http://localhost:9876/log', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
id: 'abc123',
location: 'cart.js:15',
timestamp: Date.now(),
data: { total, discount, items }
})
}).catch(() => {});
// #endregion agentic-debug-abc123Python
# region agentic-debug-abc123
try:
import urllib.request as __req, json as __json
__req.urlopen(__req.Request(
'http://localhost:9876/log',
data=__json.dumps({
'id': 'abc123',
'location': 'cart.py:15',
'timestamp': __import__('time').time(),
'data': {'total': total, 'discount': discount}
}).encode(),
headers={'Content-Type': 'application/json'}
))
except: pass
# endregion agentic-debug-abc123Supported Languages
Language | Extensions |
JavaScript |
|
TypeScript |
|
Python |
|
Requirements
Node.js >= 18.0.0
An MCP-compatible AI coding assistant
License
MIT
Available Tools
7 toolsadd_instrumentB
Add a debug instrument at a specific line in a file. The instrument will log variable values when executed.
Inputs: file (required), line (required), capture.
clear_debug_logsB
Clear all collected debug logs.
Inputs: no named parameters.
list_instrumentsB
List all active debug instruments.
Inputs: no named parameters.
read_debug_logsB
Read the collected debug logs from the current session.
Inputs: format.
remove_instrumentsC
Remove debug instruments from files.
Inputs: file.
start_debug_sessionC
Start a debug session. This starts a local HTTP server to receive logs from instrumented code.
Inputs: port.
stop_debug_sessionA
Stop the current debug session and shut down the log server.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose with no overlap: adding, listing, and removing instruments; starting and stopping debug sessions; and reading and clearing logs. The descriptions make it easy to differentiate between them, such as distinguishing 'add_instrument' from 'remove_instruments' and 'read_debug_logs' from 'clear_debug_logs'.
All tool names follow a consistent verb_noun pattern using snake_case, such as 'add_instrument', 'clear_debug_logs', and 'start_debug_session'. There are no deviations in naming conventions, making the set predictable and easy to understand.
With 7 tools, the count is well-scoped for a debugger server, covering core operations like instrument management, session control, and log handling. Each tool earns its place without feeling excessive or insufficient for the domain.
The tool set provides complete coverage for a debugger's lifecycle: it includes CRUD operations for instruments (add, list, remove), session management (start, stop), and log handling (read, clear). There are no obvious gaps, as all essential workflows are supported without dead ends.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
MCP server for Sentry - error monitoring, issue tracking, and debugging for AI assistants
A Model Context Protocol server for Wix AI tools
Related MCP Servers
- AlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server designed to easily dump your codebase context into Large Language Models (LLMs).12 npm3Apache 2.0
- FlicenseNot gradedqualityAmaintenanceAn MCP server and VS Code extension that enables AI clients to interactively debug code using breakpoints, execution control, and state inspection. It is language-agnostic and works with any debugger that supports VS Code's launch.json configurations.-
- AlicenseNot gradedqualityCmaintenanceMCP server that lets AI coding tools control and observe a running Node.js process through the chrome devtools protocol (CDP), via a lightweight Debug Adapter Protocol (DAP) bridge.24 npm2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for AI-assisted Python debugging using debugpy and Debug Adapter Protocol, enabling AI agents to run tests, set breakpoints, and inspect variables via natural language.8MIT