Skip to main content
Glama
dsh-codex-bridge

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

Инструменты 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers