1C Syntax MCP Server
MCP-сервер для поиска и проверки синтаксиса 1С, который сам распаковывает справку из установленной платформы при первом запуске
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает файл справки из установленной платформы и строит локальный индекс
- Не подключается к базе 1С и не изменяет файлы конфигурации
Установка
Ручная установка
python -m venv venv && venv\Scripts\activate && pip install mcpСоздание окружения и установка зависимости mcp, далее нужен установленный 7z.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер при первом запуске сам находит установленную версию 1С 8.3.x или 8.5.x, извлекает файл справки shcntx_ru.hbk, распаковывает его архиватором 7z (около 52000 файлов), парсит HTML и строит JSON-индекс размером около 24 МБ. Дальше он работает уже с готовым индексом и стартует за секунды. Агенту доступны четыре инструмента: поиск функций и методов по имени на русском или английском, получение детальной информации о функции, автодополнение по частичному имени и проверка синтаксиса вызова. В комплект входит отдельный навык 1cskills для OpenCode с правилами по директивам компиляции, областям модулей, языку запросов и структуре проекта, который активируется на файлах .bsl и .os.
Для кого. Для 1С-разработчиков в OpenCode, которым нужна проверка синтаксиса и справка по функциям платформы без похода в документацию вручную.
Подходит, если
- Нужен быстрый поиск функций платформы 1С по русскому или английскому имени
- Хотите, чтобы агент проверял синтаксис вызова функции перед вставкой кода
- Работаете в OpenCode и готовы поставить локальный навык 1cskills
Не подходит, если
- На машине не установлена платформа 1С 8.3.x или 8.5.x: сервер не найдет файл справки
- Нет архиватора 7z и нет возможности его поставить
Пример запроса к агенту
Найди в справке 1С функцию СтрДлина и проверь синтаксис моего вызова СтрДлина("текст", 1)Ограничения
Первый запуск занимает 1-2 минуты на распаковку и индексацию, обязательно нужен установленный 7z в PATH. Сервер ищет платформу 1С по фиксированному списку стандартных путей, при нестандартной установке потребуется вмешательство. README прямо указывает, что весь проект создан с помощью OpenCode.
Как отключить. Удалите блок 1c-syntax из opencode.jsonc и, при желании, папку 1c-syntax-mcp с индексом syntax_tree.json.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Проверка безопасности
- Только читает файл справки из установленной платформы и строит локальный индекс
- Не подключается к базе 1С и не изменяет файлы конфигурации
Коротко о README
README описывает автоматическую инициализацию сервера, установку виртуального окружения и зависимости mcp, требование 7z, настройку в opencode.jsonc для Windows и Linux/Mac, четыре MCP-инструмента с параметрами и примерами, отдельный навык 1cskills с инструкцией установки для OpenCode и подробный раздел troubleshooting по поиску платформы и файла shcntx_ru.hbk.
Частые вопросы
Нужно ли качать справку отдельно?
Нет, сервер сам находит и распаковывает shcntx_ru.hbk из установленной платформы при первом запуске.
Работает ли с английскими именами функций?
Да, поиск и автодополнение поддерживают и русские, и английские идентификаторы.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything