dsh-codex-bridge
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_statusModelo 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 esmeriladoAPI 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/agentsHerramientas MCP
Herramienta | Descripción |
| Inicia una tarea asíncrona, devuelve taskId + dashboardUrl |
| Lee eventos incrementalmente por cursor (≤64 KiB) |
| Cancela una tarea en ejecución |
| Lista todas las tareas con estado |
| Salud y estadísticas del puente |
Máquina de estados
queued → running → succeeded
→ failed
→ timed_out
→ cancelled
→ orphanedConfiguració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 |
| Listar tareas |
GET |
| Detalle de tarea |
POST |
| Crear tarea |
POST |
| Cancelar tarea |
POST |
| Reintentar tarea |
GET |
| Obtener eventos (cursor) |
GET |
| Descargar artefacto |
GET |
| 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
└── LICENSELicencia
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Hosted MCP server and Agent Skills for specs, engineering threads, and project memory.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
Related MCP Servers
- AlicenseAqualityDmaintenanceA portable MCP server that provides a shared persistent working state for AI coding agents, managing tasks, plans, notepads, memory, and project rules across different tools like Claude Code, OpenCode, and Cursor.614 npmMIT
- AlicenseNot gradedqualityCmaintenanceMCP server that enables AI coding agents to communicate, share state, and coordinate work in real time via MCP tools or REST API.84 npm10MIT
- AlicenseCqualityCmaintenanceAn MCP server that gives AI coding assistants persistent memory across sessions with chain-based project tracking, tickets, and structured handoffs.42GPL 3.0
- AlicenseAqualityDmaintenanceA local MCP server that enables multiple AI coding tools to share structured project state (decisions, tasks, bugs) so they coordinate without re-explaining.5MIT