Skip to main content
Glama
Sign In
deenesjakoruzh
dsh-codex-bridge

dsh-codex-bridge

by Lavender3533
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

dsh-codex-bridge

DSH-Plugin / MCP-Server – Ermöglicht MCP-Clients wie Codex, Claude Code, Cursor, DSH als externen, wiederaufnehmbaren Sub-Agenten zu nutzen.

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/)]

Funktionen

  • 5 MCP-Tools: dsh_task_start, dsh_task_poll, dsh_task_cancel, dsh_task_list, dsh_get_status

  • Asynchrones Aufgabenmodell: Start kehrt sofort zurück, Abruf von Ereignissen über Cursor

  • Wiederaufnehmbar: Neustart der Bridge stellt laufende Aufgaben wieder her, verwirft abgestorbene

  • Visuelles Dashboard: http://127.0.0.1:3101/agents – Milchglas-UI

  • REST-API: Vollständige Aufgabenverwaltungs-API

  • SSE-Stream: Echtzeit-Aufgabenereignisse

  • Sicherheit: Bearer-Token, nur 127.0.0.1, CWD-Einschränkung

Related MCP server: agent-comm

Schnellstart

# 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

MCP-Tools

Tool

Beschreibung

dsh_task_start

Startet eine asynchrone Aufgabe, gibt taskId + dashboardUrl zurück

dsh_task_poll

Liest Ereignisse inkrementell per Cursor (≤64 KiB)

dsh_task_cancel

Bricht eine laufende Aufgabe ab

dsh_task_list

Listet alle Aufgaben mit Status

dsh_get_status

Bridge-Integrität und Statistiken

Zustandsautomat

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

Codex-Konfiguration

[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"
]

API-Endpunkte

Methode

Pfad

Beschreibung

GET

/api/agents/tasks

Aufgaben auflisten

GET

/api/agents/tasks/:taskId

Aufgabendetail

POST

/api/agents/tasks

Aufgabe erstellen

POST

/api/agents/tasks/:taskId/cancel

Aufgabe abbrechen

POST

/api/agents/tasks/:taskId/retry

Aufgabe wiederholen

GET

/api/agents/tasks/:taskId/events

Ereignisse abrufen (Cursor)

GET

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

Artefakt herunterladen

GET

/api/agents/stream

SSE-Ereignisstrom

Dashboard

Das Dashboard unter http://127.0.0.1:3101/agents bietet:

  • Linkes Panel: Aufgabenliste mit Statusfilter

  • Mitte: Echtzeit-Ereignisstrom (stdout/stderr/Status)

  • Rechtes Panel: Aufgabendetails (PID, Zeitmessung, Artefakte)

  • Dunkel/Hell-Modus: Folgt Systemeinstellung

Architektur

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

Lizenz

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

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers