Команды

Справочник команд обвязки edt-bridge-mcp: вызов инструмента из командной строки, список инструментов, состояние моста и самообновление.

Обвязка edt-bridge-mcp – это не только stdio-сервер для MCP-клиента. Тем же исполняемым файлом можно вызвать мост прямо из командной строки: посмотреть, поднят ли он, какие инструменты отдаёт и что отвечает конкретный из них. Это удобнее, чем поднимать агента, когда нужно всего лишь проверить, живо ли всё.

Без команды обвязка работает как MCP-сервер – так её запускает клиент. Команды ниже адресуют тот же мост.

Код возврата разводит две разные беды: 1 – вызов не состоялся (мост не поднялся, аргументы неверны), 2 – инструмент отработал и вернул ошибку. В скриптах это разница между “мост лежит” и “мост жив, но задача не выполнена”.

Без команды: запуск MCP-сервера

stdio-обвязка MCP для плагина edt-bridge к 1С:EDT: проксирует запросы в запущенный EDT, а если ни одного нет – поднимает headless.

usage: edt-bridge-mcp [опции]                   (без команды: запуск MCP-сервера)
       edt-bridge-mcp <команда> [опции]

Параметры

Команды

Опции команды: edt-bridge-mcp <команда> --help. Опции выше относятся и к режиму MCP-сервера, и к каждой команде.

edt-bridge-mcp call

Вызвать один инструмент моста и напечатать результат.

usage: edt-bridge-mcp call [-h] [--json JSON | --json-file PATH | --stdin] [--raw]
                           [--workspace WORKSPACE] [--edt-dir EDT_DIR] [--port PORT]
                           [--start-timeout START_TIMEOUT] [--no-autostart]
                           [--version]
                           tool

Аргументы

Параметры

Аргументы инструмента принимаются из --json, файла (--json-file) или потока ввода (--stdin). На Windows кириллица в аргументах надёжнее всего доезжает файлом: консольная кодировка в командной строке её портит.

edt-bridge-mcp tools

Перечислить инструменты, которые отдаёт запущенный мост.

usage: edt-bridge-mcp tools [-h] [--raw] [--workspace WORKSPACE] [--edt-dir EDT_DIR]
                            [--port PORT] [--start-timeout START_TIMEOUT]
                            [--no-autostart] [--version]

Параметры

edt-bridge-mcp status

Состояние запущенного моста (сам его не поднимает).

usage: edt-bridge-mcp status [-h] [--workspace WORKSPACE] [--edt-dir EDT_DIR]
                             [--port PORT] [--start-timeout START_TIMEOUT]
                             [--no-autostart] [--version]

Параметры

edt-bridge-mcp shutdown

Штатно завершить EDT, обслуживающую мост, - вместо taskkill по процессам. Headless обвязка поднимет заново при следующем вызове; GUI без --force не трогается.

usage: edt-bridge-mcp shutdown [-h] [--force] [--no-wait] [--workspace WORKSPACE]
                               [--edt-dir EDT_DIR] [--port PORT]
                               [--start-timeout START_TIMEOUT] [--no-autostart]
                               [--version]

Параметры

edt-bridge-mcp gui

Передать воркспейс клиентской EDT: остановить headless, дождаться, пока его процессы действительно исчезнут, и запустить окно EDT на том же воркспейсе. Сама обвязка headless при этом не поднимает.

usage: edt-bridge-mcp gui [-h] [--force] [--timeout TIMEOUT] [--workspace WORKSPACE]
                          [--edt-dir EDT_DIR] [--port PORT]
                          [--start-timeout START_TIMEOUT] [--no-autostart] [--version]

Параметры

edt-bridge-mcp plugins

Перечислить плагины обвязки: пакеты, точки расширения и добавленные ими инструменты. Плагины живут в окружении самой обвязки (pipx inject), мост для этой команды не нужен.

usage: edt-bridge-mcp plugins [-h] [--workspace WORKSPACE] [--edt-dir EDT_DIR]
                              [--port PORT] [--start-timeout START_TIMEOUT]
                              [--no-autostart] [--version]

Параметры

edt-bridge-mcp self-update

Обновить jar плагина в dropins у EDT, саму обвязку в её окружении и плагины обвязки.

usage: edt-bridge-mcp self-update [опции]

Параметры

Jar применится при следующем запуске EDT. Обвязка заменяется прямо в site-packages; exe в Scripts не трогаются, поэтому запущенные edt-bridge-mcp надо перезапустить. Плагины обновляются через pip из своего источника установки (git-репозиторий или реестр пакетов; реестру можно указать адрес переменной EDT_BRIDGE_PLUGIN_INDEX).