Aidb

AI Debugger

[](https://badge.fury.io/py/ai-debugger-inc) [](https://pypi.org/project/ai-debugger-inc/) [](https://github.com/ai-debugger-inc/aidb/blob/main/LICENSE) [](https://pepy.tech/project/ai-debugger-inc) [](https://github.com/ai-debugger-inc/aidb)

AI-Powered Debugging for Every Language

AI Debugger (AIDB) brings the proven Debug Adapter Protocol (DAP) ecosystem to AI agents through a standardized Model Context Protocol (MCP) interface. Debug Python, JavaScript, TypeScript, and Java programs using the same battle-tested adapters that power VS Code—no IDE required, no heavyweight dependencies, just powerful debugging at your AI assistant's fingertips.

Read the Docs | Join Discord | Star on GitHub

______________________________________________________________________

Quick Install

Get started with Python debugging in under 60 seconds:

pip install ai-debugger-inc

Add to your MCP client settings (Claude Code, Cline, Cursor, etc.):

{
  "mcpServers": {
    "ai-debugger": {
      "command": "python",
      "args": ["-m", "aidb_mcp"]
    }
  }
}

Ask your AI assistant:

> "Initialize debugging for Python. Debug app.py with a breakpoint at line > 25."

JavaScript/Java? Visit the docs for multi-language setup.

______________________________________________________________________

Why AI Debugger?

Standalone & Zero Heavy Dependencies

No VS Code required. No heavyweight IDEs. Just install with pip and you're debugging––works on macOS, Linux, and Windows (WSL supported).

The core Python dependencies are lightweight and minimal:

dependencies = [
  "aiofiles",
  "mcp",
  "psutil"
]

Debug adapters are built during the release pipeline and are published as release artifacts. Once the ai-debugger-inc package is installed, your agent will use the download tool to fetch the appropriate adapter binaries automatically on first run.

Multi-Language from Day One

Debug Python, JavaScript, TypeScript, and Java with a single MCP server. AIDB is designed to support all DAP-compatible adapters, with more languages coming.

Built on the DAP Standard

AIDB uses the same Debug Adapter Protocol that powers VS Code debugging. We integrate with proven, open-source debug adapters:

• Python: debugpy (Microsoft)
• JavaScript/TypeScript:

vscode-js-debug (Microsoft)

• Java: java-debug (Microsoft)

This means you get reliable, well-maintained debugging that "just works" with established patterns developers already trust.

VS Code Integration (Without VS Code)

Already have complex debug configurations in launch.json? AIDB can use them directly—making sophisticated debugging setups portable and shareable across teams without requiring VS Code installations.

Advanced Debugging Features

• Framework detection: Auto-detects pytest, jest, django, spring, flask, and

more

• Conditional breakpoints: Break on user.role == "admin" or after N hits
• Logpoints: Log values without pausing execution
• Live code patching: Modify functions at runtime during debugging

Future-Ready Architecture

AIDB is built for where AI-assisted development is heading:

• CI/CD Debugging: Imagine test failures in your pipeline automatically

triggering debug sessions for deeper RCA

• Agent Tooling: Native debugging capabilities for autonomous AI agents
• Cross-Platform Consistency: Same debugging API across all environments

______________________________________________________________________

How It Works

┌──────────────────────────────────────────────────────────────────┐
│                        Your AI Assistant                         │
│                    (Claude, GPT, Local LLMs)                     │
└────────────────────────────────┬─────────────────────────────────┘
                                 │
                                 ▼
                            MCP Protocol
┌──────────────────────────────────────────────────────────────────┐
│                      AI Debugger MCP Server                      │
│         Agent-Optimized Tools (init, step, inspect, etc.)        │
└────────────────────────────────┬─────────────────────────────────┘
                                 │
                                 ▼
                            AIDB Core API
┌──────────────────────────────────────────────────────────────────┐
│                     Debug Adapter Protocol                       │
│              Language-Agnostic Debugging Interface               │
└───────────┬────────────────────┼────────────────────┬────────────┘
            │                    │                    │
            ▼                    ▼                    ▼
    ┌───────────────┐   ┌─────────────────┐   ┌───────────────┐
    │    debugpy    │   │ vscode-js-debug │   │   java-debug  │
    │    (Python)   │   │     (JS/TS)     │   │     (Java)    │
    └───────┬───────┘   └────────┬────────┘   └───────┬───────┘
            │                    │                    │
            ▼                    ▼                    ▼
       Your Python          Your Node.js          Your Java
         Program              Program              Program

The Bridge Between AI and Proven Tools

AI Debugger acts as a translation layer, exposing the mature Debug Adapter Protocol ecosystem to AI agents through a clean, agent-optimized MCP interface. Your AI assistant gets powerful debugging capabilities, and you get the reliability of debug adapters used by millions of developers worldwide.

Learn more about the architecture →

______________________________________________________________________

Supported Languages

| Language | Python | JavaScript/TypeScript | Java | | ----------------- | ----------- | --------------------- | ----------- | | Status | ✔ Available | ✔ Available | ✔ Available | | Versions | 3.10+ | Node 18+ | JDK 17+ | | Platforms | All | All | All | | Debug Adapter | debugpy | vscode-js-debug | java-debug |

Platforms: macOS, Linux, Windows (WSL recommended; native support in progress)

Coming Soon: Built to support all DAP-compatible adapters––AIDB is designed to become the debugging standard for AI systems across every popular language and framework.

______________________________________________________________________

Documentation

Getting Started

• **[Quickstart

Guide](https://ai-debugger.com/en/latest/user-guide/mcp/quickstart.html)**

• Install and debug in 5 minutes
• **[Core

Concepts](https://ai-debugger.com/en/latest/user-guide/mcp/core-concepts.html)**

• Sessions, breakpoints, execution flow
• **[Language

Guides](https://ai-debugger.com/en/latest/user-guide/mcp/languages/python.html)**

• Python, JavaScript, Java examples

Technical Reference

• **[MCP Tools

Reference](https://ai-debugger.com/en/latest/user-guide/mcp-usage.html#mcp-tools-reference)**

• Complete tool documentation
• **[API

Documentation](https://ai-debugger.com/en/latest/developer-guide/api/index.html)**

• Python API reference
• **[Advanced

Workflows](https://ai-debugger.com/en/latest/user-guide/mcp/advanced-workflows.html)**

• Remote debugging, multi-session

Architecture & Design

• **[How It

Works](https://ai-debugger.com/en/latest/developer-guide/overview.html)**

• System architecture deep dive
• **[DAP Protocol

Guide](https://ai-debugger.com/en/latest/developer-guide/adapters.html)**

• Debug Adapter Protocol reference

______________________________________________________________________

Development Setup

Prerequisites: Python 3.10+, Docker

Initial setup:

bash scripts/install/src/install.sh -v
./dev-cli info
./dev-cli completion install --yes  # optional

Common commands:

./dev-cli test run --coverage
./dev-cli docs serve --build-first -p 8000

Project Structure

• aidb/: Core debugging API, language adapters, session management
• aidb_mcp/: MCP server exposing debugging tools to AI agents
• aidb_cli/: Developer CLI for testing, Docker, adapter builds
• aidb_common/, aidb_logging/: Shared utilities and structured

logging

For architecture details and implementation guidance, see the Developer Guide.

______________________________________________________________________

Robust Testing & Releases

AIDB is built with a comprehensive CI/CD pipeline:

• Thorough E2E Testing: Multi-language, multi-framework integration tests
• Automated Releases: Reliable version management and publishing
• Continuous Quality: The test suite is run nightly and on all release PRs

We catch issues early and ship features confidently, ensuring the debugging experience you depend on stays reliable.

Our entire CI/CD release pipeline executes start to finish in under 15 minutes––a target we plan to maintain.

______________________________________________________________________

Our Vision

Becoming the debugging standard in the MCP tools space.

As AI agents become more capable, they need debugging tools designed for their workflows—not adapted from human-centric IDEs. AIDB provides a unified, language-agnostic approach to debug any program with any AI agent through the proven MCP standard.

We're building the future of AI-assisted debugging, one DAP adapter at a time.

______________________________________________________________________

Contributing

We welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) to get started.

• [Contributing Guide](CONTRIBUTING.md) - How to contribute
• [Code of Conduct](CODEOFCONDUCT.md) - Community standards
• [Security Policy](SECURITY.md) - Reporting vulnerabilities

______________________________________________________________________

Community & Support

• Documentation: ai-debugger.com
• Discord Community: [Join the

conversation](https://discord.com/invite/UGS92b6KgR)

• Issues & Features: [GitHub

Issues](https://github.com/ai-debugger-inc/aidb/issues)

______________________________________________________________________

License

AI Debugger is licensed under the Apache 2.0 License. See [LICENSE](LICENSE) for details.

______________________________________________________________________

Ready to bring debugging to your AI assistant?

Get Started | Read the Docs | Join Discord

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ai-debugger-inc
• Source: ai-debugger-inc/aidb
• License: Apache-2.0
• Homepage: https://ai-debugger.com

Install and usage instructions live in the source repository linked above.