Команды

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

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

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

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

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

usage: edt-bridge-mcp [options]           (no command: run as an MCP server)
       edt-bridge-mcp <command> [options]

stdio MCP front-end for the edt-bridge 1C:EDT plugin: proxies to a running
EDT, or auto-starts a headless one.

With no command it speaks JSON-RPC over stdin/stdout - that is how an MCP
client launches it. The commands below drive the same bridge from a shell.

options:
  -h, --help            show this help message and exit
  --workspace WORKSPACE
                        EDT workspace path for the headless auto-start
  --edt-dir EDT_DIR     EDT install dir (.../1cedt); auto-detected when omitted
  --port PORT           bridge port (default 8770)
  --start-timeout START_TIMEOUT
                        seconds to wait for a starting backend
  --no-autostart        never launch a headless EDT
  --version             show program's version number and exit

commands:
  call <tool>   call one bridge tool and print what it returned
  tools         list the tools the running bridge serves
  status        report the running bridge (never starts one)
  self-update   refresh the plugin jar and this wrapper

Run 'edt-bridge-mcp <command> --help' for a command's own options.
The options above apply to the MCP-server mode and to every command.

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

Call one bridge tool and print its result.

positional arguments:
  tool                  tool name, e.g. edt_projects (see: edt-bridge-mcp tools)

options:
  -h, --help            show this help message and exit
  --json JSON           tool arguments as a JSON object
  --json-file PATH      read the JSON object from a UTF-8 file - the reliable route
                        for arguments with non-ASCII text on Windows
  --stdin               read the JSON object from standard input
  --raw                 print the raw JSON result instead of the text the tool
                        returned
  --workspace WORKSPACE
                        EDT workspace path for the headless auto-start
  --edt-dir EDT_DIR     EDT install dir (.../1cedt); auto-detected when omitted
  --port PORT           bridge port (default 8770)
  --start-timeout START_TIMEOUT
                        seconds to wait for a starting backend
  --no-autostart        never launch a headless EDT
  --version             show program's version number and exit

Аргументы инструмента принимаются из --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]

List the tools the running bridge serves.

options:
  -h, --help            show this help message and exit
  --raw                 print the raw JSON result instead of the text the tool
                        returned
  --workspace WORKSPACE
                        EDT workspace path for the headless auto-start
  --edt-dir EDT_DIR     EDT install dir (.../1cedt); auto-detected when omitted
  --port PORT           bridge port (default 8770)
  --start-timeout START_TIMEOUT
                        seconds to wait for a starting backend
  --no-autostart        never launch a headless EDT
  --version             show program's version number and exit

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]

Report the running bridge (does not start one).

options:
  -h, --help            show this help message and exit
  --workspace WORKSPACE
                        EDT workspace path for the headless auto-start
  --edt-dir EDT_DIR     EDT install dir (.../1cedt); auto-detected when omitted
  --port PORT           bridge port (default 8770)
  --start-timeout START_TIMEOUT
                        seconds to wait for a starting backend
  --no-autostart        never launch a headless EDT
  --version             show program's version number and exit

edt-bridge-mcp self-update

usage: edt-bridge-mcp self-update [options]

Refresh the plugin jar in EDT's dropins and this wrapper in its own environment.

options:
  --jar-only        only the plugin jar (GitHub Releases)
  --pip-only        only the wrapper (PyPI, or --from)
  --from <path>     install the wrapper from a checkout instead of PyPI
  -h, --help        show this message

The jar applies on EDT's next restart. The wrapper is replaced inside site-packages;
the exes in Scripts are left alone, so restart any running edt-bridge-mcp afterwards.