Skip to main content
Glama
Lavender3533

dsh-codex-bridge

by Lavender3533

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

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

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