SkillFoxx

Начните вводить название, задачу или сервис

1C Syntax Helper MCP Server

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

MCP-серверСредний рискРоссийский стек

antonio1c/1c-syntax-helper-mcpАвтор: Antonio1C

Установка

docker compose up -d
curl http://localhost:8000/health

Выполнять в клоне репозитория после копирования файла справки в data/hbk/1c_documentation.hbk.

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

Что делает

Сервер разбирает файл справки платформы в формате .hbk, индексирует его в Elasticsearch и отвечает агенту на вопросы о встроенном языке. Через три инструмента агент ищет глобальные функции вроде СтрДлина, методы и свойства объектов вроде ТаблицаЗначений.Добавить и получает полное описание объекта со всеми методами, свойствами и событиями. Индексация идет в фоне при первом запуске, переиндексацию можно запустить параметром или через API. Автор рассчитывает на один общий сервер в локальной сети для нескольких разработчиков.

Для кого. Для команд разработчиков 1С, которые хотят, чтобы агент сверялся с официальным синтакс-помощником, а не угадывал методы.

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

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

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

  • Нужен поиск по коду и метаданным своей конфигурации, а не по справке платформы
  • Нет ресурсов на Elasticsearch: сервис занимает около 2 ГБ памяти

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

Проверь по синтакс-помощнику, какие параметры у метода ТаблицаЗначений.Свернуть

Ограничения

Файл справки .hbk в репозиторий не входит, его нужно взять из своей установки платформы. Нужны Docker и Elasticsearch, встроенной авторизации у сервиса нет, поэтому выставлять его за пределы доверенной сети не стоит. Файла лицензии в репозитории нет, хотя README упоминает MIT. Примеры конфигурации клиентов в разных документах расходятся.

Как отключить. Удалите сервер 1c-syntax-helper из настроек MCP клиента и остановите контейнеры командой docker compose down.

MCP

Транспорт
http
Авторизация
не нужна
Переменные окружения
ELASTICSEARCH_HOST
Адрес Elasticsearch
ELASTICSEARCH_PORT
Порт Elasticsearch
REINDEX_ON_STARTUP
Переиндексировать справку при запуске

Проверка безопасности

  • Поднимает Elasticsearch и HTTP-сервис без авторизации

Коротко о README

README описывает локальный запуск через Docker Compose с файлом справки в data/hbk, сборку образов для серверов на AMD64 и ARM64 и подключение VS Code. Приведена архитектура: общий Elasticsearch и FastAPI-сервер, к которому ходят несколько рабочих мест. Перечислены три MCP-инструмента, порядок переиндексации и обновления справки, диагностика через логи и эндпоинты состояния.

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

Где взять файл .hbk?

В каталоге установленной платформы 1С:Предприятие, автор ориентируется на версию 8.3.24 и новее.

Как обновить справку после выхода новой платформы?

Остановить сервисы, заменить файл .hbk, запустить их снова и вызвать перестройку индекса через API.

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний риск286,6 тыс.
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск262 тыс.
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний риск136,8 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Выбор редакции

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,3 тыс.