SkillFoxx
Telegram

mcp-baf

MCP-сервер на Python для BAF (украинский аналог 1С:УНФ): метаданные конфигурации, запросы, полнотекстовый поиск по BSL-коду и справка по функциям платформы

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

Расширенный доступ

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

  • Инструмент execute_query выполняет запросы к живой базе, хотя и ограничен только SELECT
  • Учетные данные пользователя HTTP-сервиса хранятся в конфигурации MCP-клиента
Все причины и проверки

andriy4k07/mcp-bafАвтор:andriy4k07

Установка

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

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.

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

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

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Инструмент execute_query выполняет запросы к живой базе, хотя и ограничен только SELECT
  • Учетные данные пользователя HTTP-сервиса хранятся в конфигурации MCP-клиента

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

Что делает

Сервер публикует 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

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

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

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.

Ограничения

Полнотекстовый поиск по коду требует ручной выгрузки конфигурации DumpConfigToFiles и флага --dump, без нее работают только остальные инструменты. HTTP-сервис на macOS не поддерживается платформой BAF, а недокументированный параметр /HTTPPort работает только на Windows. Минимальная поддерживаемая версия платформы 8.3.10. Требует Python 3.11+ и отдельную установку расширения в базу.

Как отключить. Уберите mcp-baf из конфигурации MCP клиента и отключите расширение MCPService в базе через список расширений в Конфигураторе.

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

Работает ли это с российским 1С:УНФ?

Проект нацелен на платформу BAF, украинский аналог 1С:УНФ. Есть опция --lang ru для русских синонимов объектов расширения, но целевая платформа не 1С.

Нужен ли интернет или облачный AI?

Нет, сервер локальный процесс и работает с любым MCP-клиентом, включая локальные модели вроде Ollama, данные базы никуда не уходят кроме выбранного клиента.

Обсуждение

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

MCP-серверы

MCP-сервер шаблонов 1С

MCP сервер шаблонов 1С

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

MCP-сервер для хранения и поиска своих шаблонов кода BSL с веб-редактором и подсветкой синтаксиса

MCP-серверРасширенный доступ18
Российский стек

MCP-сервер на Go одним бинарником: агент видит метаданные базы 1С, ищет по коду, выполняет запросы на чтение и пишет точный BSL

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

MCP-сервер с гибридным поиском по 2262 шаблонам кода BSL от сообщества и CRUD веб-интерфейсом на Monaco Editor

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

Небольшой MCP-сервер, который запускает BSL Language Server как JAR-файл и отдает агенту анализ и форматирование BSL-кода в JSON

MCP-серверРасширенный доступ6
Российский стек

MCP-сервер со справочником платформы 1С и проверкой BSL-кода на соответствие реальному API нужной версии платформы

MCP-серверРасширенный доступ33
Российский стек

Read-only MCP-сервис гибридного поиска по коду 1С BSL: BM25 плюс векторный поиск, дедупликация и reranking

MCP-серверРасширенный доступ3

Коротко о README

README на украинском описывает сервер как порт Go-проекта feenlace/mcp-1c и перечисляет девять инструментов, 11 промптов, три режима поиска по коду с BSL-синонимами и дисковый кеш индекса. Даны шаги установки: клонирование, установка пакета, установка расширения командой --install, публикация HTTP-сервиса и настройка MCP-клиента, включая отдельную команду для Claude Code. Таблицы покрывают конфигурационные флаги, переменные окружения, логирование и совместимость по ОС и клиентам. Лицензия MIT.

Бейдж для README

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