Skip to main content
Glama
Lavender3533

dsh-codex-bridge

by Lavender3533

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

기능

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

빠른 시작

# 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 도구

도구

설명

dsh_task_start

비동기 작업 시작, taskId 및 dashboardUrl 반환

dsh_task_poll

커서로 이벤트를 점진적으로 읽기 (≤64 KiB)

dsh_task_cancel

실행 중인 작업 취소

dsh_task_list

모든 작업 목록 및 상태 표시

dsh_get_status

브리지 상태 및 통계

상태 머신

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

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

API 엔드포인트

Method

Path

설명

GET

/api/agents/tasks

작업 목록 조회

GET

/api/agents/tasks/:taskId

작업 상세

POST

/api/agents/tasks

작업 생성

POST

/api/agents/tasks/:taskId/cancel

작업 취소

POST

/api/agents/tasks/:taskId/retry

작업 재시도

GET

/api/agents/tasks/:taskId/events

이벤트 가져오기 (커서)

GET

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

아티팩트 다운로드

GET

/api/agents/stream

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
└── LICENSE

라이선스

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