Skip to main content
Glama
Lavender3533

dsh-codex-bridge

by Lavender3533

dsh-codex-bridge

Плагин DSH / MCP-сервер — позволяет клиентам MCP, таким как Codex, Claude Code, Cursor, использовать 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 — интерфейс с матовым стеклом

  • 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 КБ)

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

Метод

Путь

Описание

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

  • Правая панель: детали задачи (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