MCP Debugger
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CODELLDB_PATH | No | Path to an existing CodeLLDB installation (required on macOS or Windows, as the published npm bundle only ships Linux x64 CodeLLDB runtime) | |
| SKIP_ADAPTER_VENDOR | No | Set to 'true' in CI environments to skip vendoring debug adapters during installation |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_debug_sessionA | Create a new debugging session. Provide host and port to attach to a running process; omit them for launch mode |
| list_supported_languagesA | List all supported debugging languages with metadata |
| list_debug_sessionsB | List all active debugging sessions |
| set_breakpointA | Set a breakpoint. Setting breakpoints on non-executable lines (structural, declarative) may lead to unexpected behavior |
| start_debuggingC | Start debugging a script |
| attach_to_processB | Attach to a running process for debugging |
| detach_from_processA | Detach from the debugged process without terminating it |
| close_debug_sessionC | Close a debugging session |
| step_overD | Step over |
| step_intoD | Step into |
| step_outD | Step out |
| continue_executionD | Continue execution |
| pause_executionC | Pause a running program |
| list_threadsB | List all threads in the debugged process |
| get_variablesD | Get variables (scope is variablesReference: number) |
| get_local_variablesA | Get local variables for the current stack frame. This is a convenience tool that returns just the local variables without needing to traverse stack->scopes->variables manually |
| get_stack_traceD | Get stack trace |
| get_scopesC | Get scopes for a stack frame |
| evaluate_expressionA | Evaluate expression in the current debug context. Expressions can read and modify program state |
| get_source_contextB | Get source context around a specific line in a file |
| redefine_classesA | Hot-swap changed Java classes into a running JVM. Scans a classes directory for .class files modified after sinceTimestamp, matches them against loaded classes in the target JVM, and redefines them using JDI. Returns which classes were redefined and the newest file timestamp (pass as sinceTimestamp on next call for incremental updates). Only works with Java debug sessions. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 21 tools
Most tools are clearly distinct (session lifecycle, breakpoints, stepping, inspection), but start_debugging vs create_debug_session vs attach_to_process have some overlap in session creation. get_variables vs get_local_variables is intentional convenience but could cause confusion.
Consistent verb_noun pattern (create_, list_, set_, get_, step_, continue_, pause_, attach_, detach_, close_, evaluate_). Minor deviation: redefine_classes uses a verb_object pattern but is still readable and consistent with the style.
21 tools is on the heavier side but appropriate for a full debugger surface covering session lifecycle, breakpoints, stepping, inspection, and evaluation. Each tool maps to a standard debugger operation, so the count is justified.
Covers the core debugger lifecycle well: create/attach/start, breakpoints, stepping, continue/pause, threads, stack, scopes, variables, evaluation, and source context. Minor gaps: no remove_breakpoint, no disconnect/terminate distinction beyond detach/close, and no explicit session selection parameter on inspection tools (assumed current session).