omniroute-mcp-bridge

stdio MCP-мост, который DSH запускает как дочерний процесс (через плагин dsh-mcp-client, transport: stdio). Он проксирует tools/list / tools/call к streamable-http MCP-серверу omniroute по адресу https://llm.claassen.family/api/mcp/stream и отдаёт модели только инструменты из allow-list.

Зачем

• Сессия upstream streamable-http умирает при простое ("Unknown Mcp-Session-Id" 404). Мост обнаруживает именно этот сбой, закрывает устаревший клиент, заново выполняет MCP initialize handshake (новый session id) и повторяет запрос — поэтому мёртвая upstream-сессия больше не ломает вызов инструмента.

• Плагин dsh-mcp-client не имеет конфигурации фильтрации инструментов. Этот мост фильтрует tools/list на стороне сервера, поэтому наружу отдаётся только omniroute_web_search вместо ~70 инструментов (экономия контекста модели; сохраняется стабильный serverName: omniroute, так что публичное имя остаётся mcp__omniroute__omniroute_web_search).

• Заголовок авторизации upstream передаётся через env дочернего процесса, а не через argv — секрет никогда не появляется в списке процессов. Он хранится только в cordis.patch.yml с правами 0600 в веб-профиле.

Related MCP server: mcp-streaming-http-proxy

Файлы

Подключение SDK

package.json закрепляет @modelcontextprotocol/sdk ровно на той версии, под которую разрабатывался мост. Получить её можно двумя способами:

• Автономно: npm install в этой директории.

• Внутри DSH-хоста (в данном развёртывании): node_modules — это симлинк на /usr/lib/node_modules/@deepseek-ai/dsh/node_modules, поэтому мост всегда использует ту же сборку SDK, что и собственный плагин mcp-client в DSH. Симлинк игнорируется Git — создайте его заново после клонирования в этом окружении:

  ln -sfn /usr/lib/node_modules/@deepseek-ai/dsh/node_modules node_modules

Конфигурация (env, задаётся в ~/.dsh/profiles/web/cordis.patch.yml)

Тесты

Учётные данные не закоммичены. Сначала экспортируйте их (значения из вашего patch-файла):

export MCP_BRIDGE_UPSTREAM_URL='https://llm.claassen.family/api/mcp/stream'
export MCP_BRIDGE_UPSTREAM_HEADERS='{"Authorization":"Bearer …","X-Forwarded-For":"127.0.0.1"}'

Затем:

node test-reinit.mjs   # deterministic: dead session -> re-init -> success (no network needed)
node test-bridge.mjs   # live: handshake + filtered list + real search
node probe.mjs         # dump the upstream's raw tool names
node probe-ttl2.mjs    # measure upstream session idle TTL

Изменить allow-list

Отредактируйте MCP_BRIDGE_ALLOWED_TOOLS в patch-файле (первые имена через запятую из node probe.mjs). HMR include-плагина повторно применяет patch при изменении файла; плагин mcp-client перезапускает дочерний процесс моста.