mcp-1c

Small and useful local MCP for 1C:Enterprise

Маленький и полезный MCP для 1С:Предприятие

<human> Всё в репе, кроме этого абзаца, написано ИИ-агентами.

Этот MCP не требует дополнительной обвязки, кроме OneScript (и его библиотеки sql), можно добавить в проект или в глобальные настройки Cursor IDE для экономии токенов при разработки на 1С.

Скачали папку. закинули json в .cursor, в json указали путь к main.os - должно работать, подробная инструкция от роботов чуть ниже и есть в билде. Правило (rule) для агентов cursor тоже есть в репе, можно переписать, это по-сути промпт

На разработку потрачено ~10$ на токены и на 400$ времени человека, чтобы пару выходных пинать ногами ленивых и тупых роботов. Это увлекательно) Когда-нибудь они скажут так про нас))

можно раскатить скрипты из пакета: opm install -f 1c-mcp-0.2.0.ospx - пока из файла, до хаба не добрался

P.S. Есть более мощный функционально набор скиллов у коллег https://github.com/Nikolay-Shirokov/cc-1c-skills </human> <img width="666" height="362" alt="image" src="https://github.com/user-attachments/assets/79d226c5-5a6e-4842-b844-c50933d11d8a" /> <img width="934" height="336" alt="image" src="https://github.com/user-attachments/assets/e61eec94-6300-4e11-ba09-63a204fca040" />

mcp-1c-onescript — установка

MCP-сервер для работы с выгрузкой конфигурации 1С в Cursor. Даёт агенту 5 инструментов: bsl_search, xml_search, config_list, read_module, syntax_help_search — поиск по коду, метаданным и справке синтакс-помощника без ручного обхода файлов.

Инструменты

Инструмент	Что делает
bsl_search	Поиск по BSL-файлам (подстрока или regex)
xml_search	Поиск по XML-файлам конфигурации
config_list	Список файлов/каталогов конфигурации
read_module	Читает BSL-модуль: весь файл, список методов или тело конкретного метода. Принимает путь к файлу или каталогу (рекурсивный поиск *.bsl)
syntax_help_search	Поиск по справке синтакс-помощника 1С (SQLite-БД)

Требования

• OneScript 2.0+ — oscript должен быть в PATH
• Cursor IDE
• Для syntax_help_search: пакет sql (opm install sql) и БД справки (см. ниже)

Установка

1. Скопировать сервер

Скопируй папку build/ в любое место без кириллицы в пути, например:

C:\mcp-1c\

Структура получится:

C:\mcp-1c\
  main.os
  src\
    Dispatcher.os
    adapters\...
    common\...
    domain\...
    handlers\...
    usecases\...

2. Прописать в глобальный конфиг Cursor

Открой (или создай) файл %USERPROFILE%\.cursor\mcp.json и добавь сервер:

{
  "mcpServers": {
    "mcp-1c-onescript": {
      "command": "oscript",
      "args": ["C:\\mcp-1c\\main.os"],
      "env": {
        "SHCNTX_HELP_DB": "C:\\mcp-1c\\src\\data\\shcntx_help.db"
      }
    }
  }
}

Важно: путь к main.os должен быть без кириллицы. Если в пути есть кириллица (например C:\Users\Максим\...), Cursor передаёт его в искажённом виде и сервер не запускается.

Важно: не дублируй сервер в локальном .cursor/mcp.json проекта — Cursor запустит два процесса с одним именем, один из них сразу получит EOF и упадёт.

3. Перезапустить MCP в Cursor

Settings → MCP → кнопка рестарт рядом с mcp-1c-onescript. Должно появиться 5 tools.

Подключение к проекту с 1С

Чтобы агент автоматически использовал MCP при работе с выгрузкой 1С, скопируй правило в проект:

build\1c-mcp-metadata.mdc  →  <твой-проект>\.cursor\rules\1c-mcp-metadata.mdc

Правило активируется автоматически при открытии .bsl и .xml файлов конфигурации.

Установка через opm

opm install -f 1c-mcp-0.2.0.ospx

Проверка

echo '{"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1"}},"jsonrpc":"2.0","id":0}' | oscript C:\mcp-1c\main.os

Должен вернуть JSON с "result":{"protocolVersion":"2024-11-05",...}.

Лицензия

Licensed under GPL-3.0.