Skip to main content
Glama
dsh-codex-bridge

dsh-codex-bridge

by Lavender3533

dsh-codex-bridge

Complemento DSH / Servidor MCP — Permite que clientes MCP como Codex, Claude Code, Cursor utilicen DSH como un subagente externo reanudable.

flowchart LR
  C[Codex / Claude Code / Cursor / any MCP client] -->|MCP SSE| B[DSH Bridge :3101]
  B -->|spawn detached| S[Supervisor]
  S -->|dsh --profile headless| W[DSH Worker]
  S -->|持久化| F[(~/.dsh/tasks/)]

Funcionalidades

  • 5 herramientas MCP: dsh_task_start, dsh_task_poll, dsh_task_cancel, dsh_task_list, dsh_get_status

  • Modelo de tarea asíncrona: start regresa inmediatamente, consulta eventos mediante cursor

  • Reanudable: el reinicio del puente recupera tareas en ejecución, abandona las huérfanas

  • Panel visual: http://127.0.0.1:3101/agents — interfaz de vidrio esmerilado

  • API REST: API completa de gestión de tareas

  • Flujo SSE: eventos de tarea en tiempo real

  • Seguridad: token de portador, solo 127.0.0.1, restricción de directorio de trabajo

Related MCP server: agent-comm

Inicio rápido

# 1. Install as DSH plugin
dsh plugin --profile web add dsh-codex-bridge

# 2. Set token (optional, has dev default)
export DSH_CODEX_BRIDGE_TOKEN="your-32-char-token"

# 3. Start DSH
dsh web

# 4. Open dashboard
open http://127.0.0.1:3101/agents

Herramientas MCP

Herramienta

Descripción

dsh_task_start

Inicia una tarea asíncrona, devuelve taskId + dashboardUrl

dsh_task_poll

Lee eventos incrementalmente por cursor (≤64 KiB)

dsh_task_cancel

Cancela una tarea en ejecución

dsh_task_list

Lista todas las tareas con estado

dsh_get_status

Salud y estadísticas del puente

Máquina de estados

queued → running → succeeded
                 → failed
                 → timed_out
                 → cancelled
                 → orphaned

Configuración de Codex

[mcp_servers.dsh_agent]
url = "http://127.0.0.1:3101/sse"
bearer_token_env_var = "DSH_CODEX_BRIDGE_TOKEN"
startup_timeout_sec = 10
tool_timeout_sec = 45
enabled_tools = [
  "dsh_task_start",
  "dsh_task_poll",
  "dsh_task_cancel",
  "dsh_task_list",
  "dsh_get_status"
]

Puntos finales de la API

Método

Ruta

Descripción

GET

/api/agents/tasks

Listar tareas

GET

/api/agents/tasks/:taskId

Detalle de tarea

POST

/api/agents/tasks

Crear tarea

POST

/api/agents/tasks/:taskId/cancel

Cancelar tarea

POST

/api/agents/tasks/:taskId/retry

Reintentar tarea

GET

/api/agents/tasks/:taskId/events

Obtener eventos (cursor)

GET

/api/agents/tasks/:taskId/files/:file

Descargar artefacto

GET

/api/agents/stream

Flujo de eventos SSE

Panel

El panel en http://127.0.0.1:3101/agents proporciona:

  • Panel izquierdo: lista de tareas con filtro de estado

  • Centro: flujo de eventos en tiempo real (stdout/stderr/status)

  • Panel derecho: detalles de la tarea (PID, tiempos, artefactos)

  • Modo oscuro/claro: sigue la preferencia del sistema

Arquitectura

dsh-codex-bridge/
├── lib/
│   ├── index.js          DSH plugin entry + MCP server + REST API
│   ├── dashboard.html    Visual dashboard (single-file HTML/CSS/JS)
│   └── supervisor.mjs    Detached supervisor process
├── package.json
├── cordis.patch.yml
└── LICENSE

Licencia

MIT

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers