@dsh-gate/mcp-server
dsh-gate
dsh-gate позволяет Codex контролировать длительные сеансы DeepSeek Harness через MCP, сохраняя при этом независимость DSH Host и сеансов от процесса MCP.
Рабочее пространство содержит:
@dsh-gate/mcp-server: девять инструментов MCP поверх публичного сетевого клиента DSH и контроллера переподключения;@dsh-gate/supervisor-tools: инструменты передачи управления, приёма артефактов и бюджета зарегистрированных сбоев на стороне DSH;два узких операторских навыка, пример конфигурации Codex/DSH и детерминированный рабочий процесс bootstrap/doctor/Host.
Развёртывание, проверка и запуск
pnpm bootstrap # fetch the pinned DSH fork commit, build & link the exact
# network client, install the supervisor plugin into an
# isolated project-local DSH home (.dsh-state/) — never starts the Host
pnpm run doctor # verify pin, link, built artifacts, and plugin/profile
pnpm host:start # start the independent DSH Web Host on http://127.0.0.1:8080
pnpm run doctor --live # additionally verify the running Host identity/protocolЗатем скопируйте config/codex-mcp.example.toml в соответствующую конфигурацию Codex и замените заполнитель <workspace-root> на абсолютный путь этого checkout'а — это единственное значение, зависящее от конкретной машины. Исполняемый файл сервера — packages/mcp-server/dist/cli.js — если более старая конфигурация по-прежнему указывает на dist/index.js, обновите её до dist/cli.js (точка входа библиотеки не запускает MCP-сервер). Конфигурация MCP Codex поддерживает stdio-серверы с полями для команды, аргументов, окружения, таймаута запуска и таймаута инструментов.
Полное руководство оператора — предварительные требования, контракт совместимости и политика обновлений, независимость Host, видимость в браузере, чистое восстановление после сбоев и ограничение, связанное с официальными upstream-PR — читайте в DEPLOYMENT.md.
Related MCP server: Local Codex Bridge
Зафиксированный коммит форка DSH
@dsh-gate/mcp-server импортирует @deepseek-ai/dsh-client-connection/network-client, общие экспорты сетевого клиента и контроллера переподключения. Эти экспорты не входят ни в один опубликованный релиз DSH; они потребляются из публичного форка ровно в одном коммите:
форк:
https://github.com/yidapan666-creator/deepseek-harness.gitкоммит:
7212c955438c70c9a2d168f67e85a8014b8d4488
SHA коммита является контрактом совместимости — bootstrap выполняет выборку по SHA (никогда по движущейся ветке), doctor отказывается от checkout, чей HEAD отличается или чей удалённый репозиторий не идентифицирует форк, а грязный checkout отклоняется без деструктивного восстановления. Сама ссылка создаётся существующим скриптом scripts/link-local-dsh.mjs, который повторно используется bootstrap; она действует только локально, и ни один путь к машине не фиксируется в метаданных пакета. dist/cli.js сначала проверяет стык и выводит понятный диагностический текст вместо необработанной ошибки разрешения модуля, если он отсутствует.
Чтобы обновить привязку: измените DSH_PINNED_COMMIT в scripts/dsh-gate-lib.mjs, удалите .dsh-state/dsh и снова запустите pnpm bootstrap. Политику и объяснение, почему коммит форка не заявляется как upstream-слияние, см. в DEPLOYMENT.md.
Периодичность контроля
dsh_wait выполняет пятиминутный агрегированный цикл прогресса: по умолчанию он возвращает примерно одно наблюдение каждые 300000 мс, и возвращается раньше только при существенной границе супервизора — например, терминальном состоянии, запросе/вопросе, контрольной точке, блокировке или эскалации. Обычный поток событий никогда не вызывает быстрых повторных вызовов wait. Каждое наблюдение цикла агрегирует прогресс с момента предыдущего asOfSeq — дельту шагов, счётчики инструментов, дельты токенов — плюс компактную ограниченную сводку projectActivity затронутых проектных файлов, изменённых успешными правками/записями, и целевых команд проверки (например, pnpm verify). Терминальные наблюдения несут итоговые значения по области задачи. Никакие сырые логи, диффы или выводы инструментов никогда не включаются.
Поставленный в очередь промпт начинается с читаемой человеком цели и содержит долговечный пакет задачи после неё. Это сохраняет проверку протокола неизменной, делая новые контролируемые сеансы узнаваемыми по имени задачи на боковой панели DSH в веб-интерфейсе.
Детали длительной передачи управления
supervisor_handoff.summary ограничен 2048 символами. Когда задаче требуется более длинный отчёт, запишите его в Markdown в каталог .dsh-handoff/<taskId>/ внутри рабочего каталога сеанса (каталог игнорируется git), передайте относительный путь в artifacts и укажите на него в краткой сводке. Инструмент передачи управления отклоняет сводки, превышающие лимит, с точной инструкцией и сам никогда не записывает данные передачи — в частности, никогда в ~/.codex или любой другой глобальный каталог. Приём артефактов обеспечивает изоляцию: только относительные пути, без обходов, симлинков, жёстких ссылок или нерегулярных файлов, хешированные по допустимому дескриптору внутри рабочего каталога сеанса.
Статус релиза
Исходный код распространяется под лицензией MIT и подготовлен для публичного размещения на yidapan666-creator/dsh-gate: зависимость DSH является публичным форком, рабочее дерево не содержит путей, специфичных для конкретной машины, или секретов, а pnpm bootstrap проходит с управляемой ссылкой. Публикация в npm остаётся отдельным, всё ещё заблокированным решением: обе пакета не могут быть собраны или запущены при чистой установке, пока не будет опубликован шов @deepseek-ai/dsh-client-connection/network-client (пин форка работает для воспроизводимых сборок из исходников, но не для установки пакетов из реестра).
Оставшееся ограничение upstream — публикация в npm: обе пакета не могут быть собраны или установлены без опубликованного @deepseek-ai/dsh-client-connection/network-client. Публичный пин форка на 7212c955438c70c9a2d168f67e85a8014b4488 делает сборки из исходников воспроизводимыми уже сегодня; при этом никакого слияния с upstream не заявляется.
Установка из исходников, проверка и контракт протокола описаны в документированном рабочем процессе проверки.
Смотрите docs/protocol.md о семантике состояний, docs/benchmark.md — о пути приёмки, docs/source-provenance.md — о происхождении исходного кода и лицензиях, docs/source-backed-reuse-review.md — о ретроспективном обзоре дизайна. Для контрибьюторов: CONTRIBUTING.md. Для сообщений об уязвимостях: SECURITY.md.
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
A paid remote MCP for OpenAI Codex agent coordination MCP, built to return verdicts, receipts, usage
A paid remote MCP for OpenAI Codex harness MCP, built to return verdicts, receipts, usage logs, and
Project management shared by people and AI agents, with persistent project state through MCP.
Hosted MCP server and Agent Skills for specs, engineering threads, and project memory.
Related MCP Servers
- AlicenseAqualityCmaintenanceA local STDIO MCP server that bridges Codex to the official DeepSeek Harness (DSH) Web Host, enabling supervised DSH collaboration through session management, delegation, and monitoring tools.1312MIT
- AlicenseNot gradedqualityBmaintenanceEnables external AI supervisors to oversee and steer native Codex through MCP, including thread and turn management, observation, interruption, approval responses, runtime status, and checkpointing.MIT
- AlicenseNot gradedqualityBmaintenanceEnables Codex to delegate scoped tasks to a local DeepSeek Harness over MCP — dispatching read-only reviews or authorized workspace writes, steering and monitoring runs to a terminal state, and returning structured evidence such as changed paths, test results, and assistant text. It also supports exact archival of the terminal session by full session ID.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables Codex to delegate selected tasks to a locally installed DeepSeek Harness through MCP tools for execution, status, planning, and feedback while keeping orchestration local.16 npm2MIT