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/)]5개의 MCP 도구: dsh_task_start, dsh_task_poll, dsh_task_cancel, dsh_task_list, dsh_get_status
비동기 작업 모델: 시작은 즉시 반환, 커서를 통해 이벤트 폴링
재개 가능: 브리지 재시작 시 실행 중인 작업은 복구되고, 종료된 작업은 고립 처리됨
시각적 대시보드: http://127.0.0.1:3101/agents — 프로스트 글래스 UI
REST API: 전체 작업 관리 API
SSE 스트림: 실시간 작업 이벤트
보안: Bearer 토큰, 127.0.0.1 전용, 현재 작업 디렉터리 제한
Related MCP server: agent-comm
# 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도구 | 설명 |
| 비동기 작업 시작, taskId 및 dashboardUrl 반환 |
| 커서로 이벤트를 점진적으로 읽기 (≤64 KiB) |
| 실행 중인 작업 취소 |
| 모든 작업 목록 및 상태 표시 |
| 브리지 상태 및 통계 |
queued → running → succeeded
→ failed
→ timed_out
→ cancelled
→ orphaned[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"
]Method | Path | 설명 |
GET |
| 작업 목록 조회 |
GET |
| 작업 상세 |
POST |
| 작업 생성 |
POST |
| 작업 취소 |
POST |
| 작업 재시도 |
GET |
| 이벤트 가져오기 (커서) |
GET |
| 아티팩트 다운로드 |
GET |
| SSE 이벤트 스트림 |
http://127.0.0.1:3101/agents에 있는 대시보드는 다음을 제공합니다:
왼쪽 패널: 상태 필터가 있는 작업 목록
중앙: 실시간 이벤트 스트림 (stdout/stderr/상태)
오른쪽 패널: 작업 세부 정보 (PID, 타이밍, 아티팩트)
다크/라이트 모드: 시스템 설정 따름
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
└── LICENSEMIT
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
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
