Skip to main content
Glama
Lavender3533

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: iStdBMAD

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

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.

  • Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lavender3533/dsh-codex-bridge'

If you have feedback or need assistance with the MCP directory API, please join our Discord server