dsh-codex-bridge
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
dsh-codex-bridge
DSH 插件 / MCP 服务器 — 让 Codex、Claude Code、Cursor 等 MCP 客户端将 DSH 当作外部可恢复子代理使用。
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/)]Features
5 MCP tools:
dsh_task_start,dsh_task_poll,dsh_task_cancel,dsh_task_list,dsh_get_statusAsync task model: start returns immediately, poll for events via cursor
Resumable: bridge restart recovers running tasks, orphans dead ones
Visual dashboard:
http://127.0.0.1:3101/agents— frosted glass UIREST API: full task management API
SSE stream: real-time task events
Security: bearer token, 127.0.0.1 only, cwd restriction
Related MCP server: agent-comm
Quick Start
# 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/agentsMCP Tools
Tool | Description |
| Start an async task, returns taskId + dashboardUrl |
| Read events incrementally by cursor (≤64 KiB) |
| Cancel a running task |
| List all tasks with status |
| Bridge health and stats |
State Machine
queued → running → succeeded
→ failed
→ timed_out
→ cancelled
→ orphanedCodex Configuration
[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 Endpoints
Method | Path | Description |
GET |
| List tasks |
GET |
| Task detail |
POST |
| Create task |
POST |
| Cancel task |
POST |
| Retry task |
GET |
| Get events (cursor) |
GET |
| Download artifact |
GET |
| SSE event stream |
Dashboard
The dashboard at http://127.0.0.1:3101/agents provides:
Left panel: task list with status filter
Center: real-time event stream (stdout/stderr/status)
Right panel: task details (PID, timing, artifacts)
Dark/light mode: follows system preference
Architecture
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
└── LICENSELicense
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