Skip to main content
Glama
Sign In
enes
hostproto-dap-debugpy

hostproto-dap-debugpy

by bayleafwalker
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

hostproto-dap-debugpy

El adaptador DAP de HostProto (plan hostproto-semantics, paso 5): una sesión de debugpy expuesta a través de MCP 2026-07-28, fijada. Las semánticas provienen de hostproto-semantics, los mismos once bundles que fija el adaptador del navegador; este repositorio posee solo el cliente DAP, el registro de threads/targets, la validación y sus propias pruebas. Es el runtime que el spike del paso 3 (docs/DAP_SPIKE.md) solicitó. Desde hostproto-semantics ADR-0012 es un binding: src/binding.ts proporciona cómo se inicia debugpy y qué dice su launch; hostproto-dap-core (fijado por commit) calcula cada semántica de HostProto y sirve MCP.

Qué hace

Superficie MCP

Objeto HostProto

hostproto_context_create (lanza un programa Python, se detiene en la entrada)

handles/v1 — host = proceso del adaptador, context = launch, surface = thread; lifecycle: creating hasta que exista el primer thread

hostproto_surface_observe

observation/v1 — la revisión avanza en cada transición stopped↔running de ese thread; el cursor es asignado por el host sobre eventos normalizados, seq de DAP es la procedencia bruta. Proyecciones: state, frames, scopes, variables, output, breakpoints, host_requests

hostproto_surface_act (la entrada es el paquete intent/v1)

receipt/v1 — set_breakpoints, step_over/in/out, continue, pause, evaluate, set_variable, host_request.resolve; una reanudación cuyo plazo expira es outcome: unknown, executed: false

hostproto_surface_await

espera del lado del host: stopped, lifecycle, revision, event_kind, host_request

hostproto_context_recovery

recovery/v1 — unrecoverable / host_terminated una vez que el debuggee ha desaparecido, con el registro de mensajes DAP sin procesar como evidencia direccionada por contenido (application/x-ndjson)

hostproto_capabilities

capability-profile/v1 para dap/v1 — disponibilidad a partir de la respuesta initialize del adaptador, runtime solo para lo que este proceso ejecutó

hostproto://surface/{id}/state, hostproto://context/{id}/dap-messages

estado suscribible; el registro de evidencia

Frames, scopes y variables son target-ref/v1 acotados a la revisión en la que fueron observados. Un variablesReference anterior a una reanudación se rechaza como target_invalidated con host_invoked: false antes de que se envíe nada — la regla que el paso 3 pidió al paso 5 demostrar en un depurador real. Los frames mientras se ejecutan están omitidos, no perdidos: bounded.omitted los cuenta, lossy sigue siendo false, una desviación explica por qué.

Una solicitud inversa runInTerminal es una solicitud de host detrás de un token de decisión, con la misma forma que un diálogo de script de navegador: los handles vuelven primero (creating), el cliente observa host_requests, resuelve con allow | deny, y la parada de entrada sigue.

Related MCP server: vibe-debug

Ejecución

npm ci
python3 -m venv .venv && .venv/bin/pip install debugpy==1.8.21   # or HOSTPROTO_PYTHON=/path/to/python with debugpy
npm test          # real client ↔ real server over stdio ↔ real debugpy ↔ real Python
npm start         # stdio server

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Debug-MCP

      Kaina3
      A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to perform interactive Python debugging with breakpoints, step execution, and variable inspection using the Debug Adapter Protocol (DAP) through an MCP server interface.
      8
      1
      MIT

    • vibe-debug

      illscience
      A
      license
      B
      quality
      D
      maintenance
      Enables coding agents to use a real debugger (Python via debugpy) for launching, attaching, setting breakpoints, stepping through code, inspecting stack frames, and evaluating expressions through MCP tools.
      12
      27
      MIT

    • DebugPilot

      inkan-tech
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to inspect debug state, control execution, and set breakpoints in VS Code by exposing the Debug Adapter Protocol as an MCP server.
      Apache 2.0

    • qwen-dap-mcp

      SLP-DEV1
      A
      license
      A
      quality
      A
      maintenance
      Enables coding agents to connect to Debug Adapter Protocol debuggers over MCP, allowing them to launch or attach to native targets, control execution, set breakpoints and watchpoints, inspect stacks, variables, memory, and exceptions, and capture agent-friendly debugger snapshots.
      18
      1,216 npm
      3
      Apache 2.0