mcp-baf
MCP-сервер на Python для BAF (украинский аналог 1С:УНФ): метаданные конфигурации, запросы, полнотекстовый поиск по BSL-коду и справка по функциям платформы
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Инструмент execute_query выполняет запросы к живой базе, хотя и ограничен только SELECT
- Учетные данные пользователя HTTP-сервиса хранятся в конфигурации MCP-клиента
Установка
Ручная установка
git clone https://github.com/andriy4k07/mcp-baf
cd mcp-baf
python -m venv .venv
.venv/bin/pip install -e .Установка на Linux/macOS, на Windows путь .venv\Scripts\pip.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер публикует HTTP-сервис внутри базы BAF через собственное расширение и отдает агенту девять инструментов: дерево метаданных, структуру объекта и формы, сведения о конфигурации, выполнение и проверку запросов только на чтение, журнал регистрации, справку по 180 встроенным функциям BSL и полнотекстовый поиск по коду с тремя режимами (BM25, regex, точное совпадение) и встроенными двуязычными BSL-синонимами. Плюс к инструментам идут 11 готовых промптов для типичных задач: ревью модуля, разбор ошибки, поиск дублей, оптимизация запроса и другие. Индекс поиска строится по локальной выгрузке конфигурации в фоновом потоке с кешем на диске и инкрементальным обновлением по времени и размеру файла. Проект это Python-порт Go-инструмента feenlace/mcp-1c с теми же инструментами и промптами.
Для кого. Для разработчиков на платформе BAF (украинский аналог 1С:УНФ, совместимый по архитектуре с 1С:Предприятие), которым нужен доступ агента к живой базе и коду конфигурации через MCP.
Подходит, если
- Нужно показать агенту структуру метаданных и форм конфигурации BAF
- Нужен полнотекстовый поиск по коду модулей с учетом русских и английских синонимов функций BSL
- Нужны запросы на чтение к живой базе с параметрами и справка по функциям BSL без запущенной платформы
Не подходит, если
- Работа ведется на классической платформе 1С:Предприятие, а не на BAF: сервер рассчитан на расширение под BAF
- На macOS: HTTP-сервисы платформы там не поддерживаются, нужна Windows-VM
Пример запроса к агенту
Покажи структуру конфигурации моей базы и найди все места, где используется функция СтрНайтиОграничения
Полнотекстовый поиск по коду требует ручной выгрузки конфигурации DumpConfigToFiles и флага --dump, без нее работают только остальные инструменты. HTTP-сервис на macOS не поддерживается платформой BAF, а недокументированный параметр /HTTPPort работает только на Windows. Минимальная поддерживаемая версия платформы 8.3.10. Требует Python 3.11+ и отдельную установку расширения в базу.
Как отключить. Уберите mcp-baf из конфигурации MCP клиента и отключите расширение MCPService в базе через список расширений в Конфигураторе.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| mcp_baf_BASE_URL | URL HTTP-сервиса базы, по умолчанию http://localhost:8080/hs/mcp-baf. |
| mcp_baf_USER обязательная | Пользователь HTTP-сервиса базы. |
| mcp_baf_PASSWORD обязательная, секрет | Пароль пользователя HTTP-сервиса. |
| mcp_baf_DUMP_DIR | Путь к выгрузке конфигурации, включает поиск по коду search_code. |
Проверка безопасности
- Инструмент execute_query выполняет запросы к живой базе, хотя и ограничен только SELECT
- Учетные данные пользователя HTTP-сервиса хранятся в конфигурации MCP-клиента
Коротко о README
README на украинском описывает сервер как порт Go-проекта feenlace/mcp-1c и перечисляет девять инструментов, 11 промптов, три режима поиска по коду с BSL-синонимами и дисковый кеш индекса. Даны шаги установки: клонирование, установка пакета, установка расширения командой --install, публикация HTTP-сервиса и настройка MCP-клиента, включая отдельную команду для Claude Code. Таблицы покрывают конфигурационные флаги, переменные окружения, логирование и совместимость по ОС и клиентам. Лицензия MIT.
Частые вопросы
Работает ли это с российским 1С:УНФ?
Проект нацелен на платформу BAF, украинский аналог 1С:УНФ. Есть опция --lang ru для русских синонимов объектов расширения, но целевая платформа не 1С.
Нужен ли интернет или облачный AI?
Нет, сервер локальный процесс и работает с любым MCP-клиентом, включая локальные модели вроде Ollama, данные базы никуда не уходят кроме выбранного клиента.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything