MCP 1C Local Bridge: агент в открытом сеансе 1С

mcp-1c-local-bridge

MCP-сервер и внешняя обработка 1С, через которые агент выполняет запросы и код в уже открытом сеансе пользователя, без шлюза и сервера посередине

  • 10 ★ репозитория
  • Последний коммит
MCP-сервер

Широкий доступ

Почему такой уровень

  • Инструменты `eval` и `execute` выполняют произвольный код 1С в сеансе пользователя с его правами
  • Запрос и метаданные открывают агенту содержимое рабочей базы, пока форма обработки открыта
Все причины и проверки
Российский стек

ntappw/mcp-1c-local-bridge

Установка

Работает в

Ручная установка

git clone https://github.com/ntappw/mcp-1c-local-bridge.git && cd mcp-1c-local-bridge && uv sync

Клонирует репозиторий и ставит зависимости сервера.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Инструменты `eval` и `execute` выполняют произвольный код 1С в сеансе пользователя с его правами
  • Запрос и метаданные открывают агенту содержимое рабочей базы, пока форма обработки открыта

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект состоит из Python-сервера по stdio и внешней обработки MCPLocalBridge.epf, которую открывают в клиенте 1С:Предприятие. Обмен идет файлами JSON в каталоге профиля пользователя: сервер кладет команду, форма обработки раз в полсекунды забирает ее, выполняет на сервере 1С с правами пользователя и пишет ответ. Агенту доступны десять инструментов: `sessions`, `ping`, `query`, `eval`, `execute`, `metadata`, `find`, `usages`, `result` и `cancel`. Есть выдача результатов с подтверждением на форме, журнал команд, переключатели «Запись в базу» и «Код на клиенте», режим для обычных форм и старых конфигураций.

Для кого. Разработчики и аналитики 1С на Windows, которым нужен агент в живой базе: запросы, разбор метаданных, поиск использований объекта.

Подходит, если

  • Агенту нужно выполнять запросы 1С и читать результат в открытой базе
  • Хочется разобрать метаданные и найти, где используется объект конфигурации
  • Данные должны оставаться на компьютере разработчика, выдачу ответов нужно подтверждать кнопкой
  • Нужен агент, который сверяет выводы запросов с реальными данными базы, а не гадает по описанию

Не подходит, если

  • Нужен доступ к базе на сервере без открытого клиента 1С: мост работает только через открытую обработку
  • Работа идет не на Windows: клиенту 1С нужна Windows, сервер можно запускать в WSL
  • Агенту нельзя давать выполнение произвольного кода в рабочей базе с правами пользователя

Пример запроса к агенту

Покажи открытые сеансы 1С и найди, где используется справочник Номенклатура

MCP

Транспорт
stdio
Авторизация
не нужна

Переменные окружения

MCP_1C_BRIDGE_DIR
Каталог обмена вместо %TEMP%\mcp-1c-local-bridge

Ограничения

Мост работает только на Windows с клиентом 1С 8.3, обработка рассчитана на режим совместимости от 8.3.14, в конфигурации должны быть разрешены синхронные вызовы. Инструменты `eval` и `execute` выполняют произвольный код 1С с правами открывшего форму пользователя, запись в базу включается отдельным переключателем на форме. На терминальном сервере нужен общий каталог обмена. Десять звезд, один автор, последний коммит в ноябре 2026 года, есть статья на Инфостарте.

Как отключить. Закройте форму обработки: сеанс удаляется, команды больше не принимаются. Затем уберите сервер из настроек MCP-клиента.

Частые вопросы

Нужен ли отдельный сервер или шлюз?

Нет, обмен идет файлами в каталоге профиля пользователя на этом же компьютере, промежуточного сервера нет.

Может ли агент менять данные в базе?

Только если на форме обработки включена «Запись в базу», при открытии формы она выключена.

Работает ли мост со старыми конфигурациями?

Да, в тонком клиенте с режимом управляемого приложения и в толстом клиенте обычного приложения, для них есть обычная форма.

Какие инструменты видит агент?

Десять: `sessions`, `ping`, `query`, `eval`, `execute`, `metadata`, `find`, `usages`, `result` и `cancel`.

Что делать с долгим запросом?

Команда ждет до `timeout`, он не больше 280 секунд. Не уложившаяся команда возвращает идентификатор, ответ забирают инструментом `result`.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

MCP-сервер на базе внешней обработки 1С: дает Claude доступ к метаданным, запросам и журналу регистрации любой конфигурации

MCP-серверШирокий доступ13Звезды репозитория
Российский стек

Внешняя обработка 1С с MCP и REST API: запросы, метаданные, журнал регистрации и выполнение кода без изменения конфигурации

MCP-серверШирокий доступ346Звезды репозитория
Российский стек

Временный MCP-мост к 1С на клиентском RDP без публикации базы: выгрузка, чтение и запись через туннель, который закрывается после задачи

MCP-серверШирокий доступ
Российский стек

Расширение 1С, которое поднимает MCP-сервер прямо внутри клиента 1С:Предприятия и позволяет описывать свои инструменты на BSL

MCP-серверРасширенный доступ69Звезды репозитория
Российский стек

Нативный компонент, который поднимает полноценный MCP-сервер внутри 1С: инструменты, ресурсы, промпты пишутся на BSL, а протокол берет на себя DLL

MCP-серверШирокий доступ43Звезды репозитория
Российский стек

MCP-мост к BSL Language Server: навигация, диагностика и рефакторинг кода 1С и OneScript для агентов

MCP-серверРасширенный доступ70Звезды репозитория

Коротко о README

README объясняет схему обмена через каталог, требования, установку через uv, работу формы и журнала, выдачу результатов с подтверждением, свой каталог обмена, таблицу из десяти инструментов и особенности обычного приложения.

Бейдж для README

Сообщить о проблеме

Foxx AIMCP 1C Local Bridge: агент в открытом сеансе 1С
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.