MCP-сервер для доступа к текстам модулей 1С: простая реализация на Node.js

25.08.25

Разработка - Инструментарий разработчика

В эпоху ИИ-инструментов, таких как Cursor (IDE на базе VS Code с встроенным AI), важно иметь доступ к контексту кода. Model Context Protocol (MCP) — это стандарт, позволяющий AI-моделям безопасно взаимодействовать с инструментами, включая чтение файлов и поиск по коду. В этой статье я расскажу, как создать минимальный MCP-сервер на Node.js, который предоставляет доступ к текстам модулей 1С из выгрузки конфигурации. Это позволит вашему AI-ассистенту в Cursor "видеть" код модулей, искать по ним и анализировать. Сервер работает в режиме STDIO (без HTTP), что упрощает запуск и интеграцию. Я опишу всё шаг за шагом, с примерами кода и настройками.

Файлы

ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.

Наименование Скачано Купить файл
(только для физ. лиц)
MCP-сервер для доступа к текстам модулей 1С: простая реализация на Node.js
.zip 3,43Mb
0 1 850 руб. Купить

Подписка PRO — скачивайте любые файлы со скидкой до 85% из Базы знаний

Оформите подписку на компанию для решения рабочих задач

Оформить подписку и скачать решение со скидкой

GitHub

Зачем это нужно?

В 1С мы часто работаем с конфигурациями, где код разбросан по модулям (общие модули, модули объектов, форм и т.д.). Стандартные MCP-серверы для 1С (как 1C_MCP_metadata) дают доступ к метаданным, но не к текстам кода. Этот сервер решает проблему: он читает файлы из выгрузки конфигурации (BSL, TXT и т.п.), позволяя AI искать строки, читать процедуры и анализировать логику.

Преимущества:

  • Доступ к тексту модулей: Поиск по regex, список файлов, чтение содержимого.
  • Локальность: Всё работает локально, без облака.
  • Интеграция с Cursor: AI может вызывать инструменты прямо из чата.
  • Простота: Минимум кода, легко расширяемо (добавьте инструменты для 1С-метаданных или OData).

 

Требования

  • Node.js >= 18 (установите с nodejs.org).
  • Каталог с выгруженной конфигурацией 1С (используйте команду DESIGNER /DumpConfigToFiles для экспорта в файлы).
  • IDE Cursor с поддержкой MCP (настройте mcp.json в ~/.cursor).
  • Зависимости: @modelcontextprotocol/sdk, globby, zod (устанавливаются через npm).

     

Установка сервера

  1. Создайте проект: В любом каталоге и загрузите файлы из репозитария
  2. Установите зависимости:  
    npm install

     

  3. Выгрузите конфигурацию 1С в файлы (пример для файловой базы):
     1cv8.exe DESIGNER /F "~ВАША БАЗА~" /DumpConfigToFiles "~КАТАЛОГ ВЫГРУЗКИ~" /Out "~КАТАЛОГ ЛОГИРОВАНИЯ~"
  4.  Настройка в Cursor IDE (В файле ~/.cursor/mcp.json добавьте:)
    {
      "mcpServers": {
        "1c-modules-stdio": {
          "command": "node",
          "args": ["~ПУТЬ ДО ПРОЕКТА~"],
          "env": {
            "MODULES_DIR": "~ПУТЬ ДО ПАПКИ С ВЫГРУЖЕННЫМИ ФАЙЛАМИ КОНФИГУРАЦИИ~"
          }
        }
      }
    }
    Перезапустите Cursor. В панели MCP Tools появится сервер с 3 инструментами.

     

    Доступные инструменты

    1. list_module_files — Список файлов по glob-шаблону (по умолчанию **/*.{bsl,txt,1c,os,md}).
    1. read_module_text — Чтение текста файла по пути (с опцией maxBytes для ограничения размера).
    1. grep_modules — Поиск по regex в файлах (глоб по умолчанию **/*.bsl).

     

    Примеры использования в Cursor

    В чате AI:

    • "Покажи список модулей BSL": Вызовет list_module_files({ pattern: "**/*.bsl" }).
    • "Выведи текст модуля CommonModules/МойМодуль/Ext/Module.bsl": read_module_text({ file: "CommonModules/МойМодуль/Ext/Module.bsl" }).
    • "Найди 'Процедура Обработка' в модулях": grep_modules({ query: "Процедура Обработка", glob: "**/*.bsl" }).
    Это позволит AI анализировать код, предлагать правки или искать ошибки.
     

    Преимущества и расширения

    • Безопасность: Доступ ограничен каталогом MODULES_DIR.
    • Расширяемость: Добавьте инструменты для вызова 1С-методов через HTTP или COM.
    • Автоматизация: Настройте регламентное задание в 1С для периодической выгрузки.

    Если добавите интеграцию с метаданными (через OData), сервер станет полноценным мостом между 1С и AI.

     

    Заключение

    Этот MCP-сервер — простой способ сделать тексты модулей 1С доступными для AI в Cursor. Он решает проблему "слепоты" ИИ к коду, ускоряя разработку. Код открыт для доработок — скачайте с [GitHub/ваш репозиторий] и адаптируйте под себя. Если есть вопросы, пишите в комментариях!

    P.S. Статья написана с помощью Grok (xAI), который и помог собрать этот сервер. 😊

Вступайте в нашу телеграмм-группу Инфостарт

MCP Cursor нейросеть AI ИИ искусственный интеллект

См. также

Инструментарий разработчика Роли и права Запросы СКД Программист Руководитель проекта 1С v8.3 Управляемые формы Запросы Система компоновки данных Платные (руб)

Инструменты для разработчиков 1С 8.3: Infostart Toolkit. Автоматизация и ускорение разработки на управляемых формах. Легкость работы с 1С.

15500 руб.

02.09.2020    207838    1142    413    

1036

Администрирование веб-серверов Сервера Нейросети Программист Платные (руб)

Сервер поиска по метаданным и поиска по коду, Сервер экспорта и поиска по документации, Сервер синтаксической проверки кода

6000 руб.

17.06.2025    13422    173    20    

66

Инструментарий разработчика Чистка данных Свертка базы Инструменты администратора БД Системный администратор Программист Руководитель проекта 1С v8.3 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 Россия Платные (руб)

Инструмент представляет собой обработку для проведения свёртки или обрезки баз данных. Работает на ЛЮБЫХ конфигурациях (УТ, БП, ERP, УНФ, КА и т.д.). Поддерживаются серверные и файловые базы, управляемые и обычные формы. Может выполнять свертку одновременно в несколько потоков. А так же автоматически, без непосредственного участия пользователя. Решение в Реестре отечественного ПО

8400 руб.

20.08.2024    37614    213    111    

201

Инструменты администратора БД Инструментарий разработчика Роли и права Программист 1С v8.3 1C:Бухгалтерия Россия Платные (руб)

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

16000 руб.

10.11.2023    17146    74    39    

90

Пакетная печать Печатные формы Инструментарий разработчика Программист 1С v8.3 Запросы 1С:Зарплата и кадры бюджетного учреждения 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 Платные (руб)

Расширение для создания и редактирования печатных форм в системе 1С:Предприятие 8.3. Благодаря конструктору можно значительно снизить затраты времени на разработку печатных форм, повысить качество и прозрачность разработки, а также навести порядок в многообразии корпоративных печатных форм.

22200 руб.

06.10.2023    24855    65    28    

94

Инструментарий разработчика Программист 1С v8.3 1С:Управление нашей фирмой 3.0 Платные (руб)

Инструмент для написания и отладки кода в режиме «1С:Предприятие». Представляет собой консоль кода с возможностью пошаговой отладки, просмотра значений переменных любых типов, использования процедур и функций, просмотра стека вызовов, вычисления произвольных выражений на встроенном языке в контексте точки останова, синтаксического контроля и остановки по ошибке. В консоли используется удобный редактор кода с подсветкой, контекстной подсказкой, возможностью вызова конструкторов запроса и форматной строки.

9500 руб.

17.05.2024    35869    130    53    

173

Нейросети 1С v8.3 Платные (руб)

Подключите Вашу 1С к ИИ. Расширение практически для любых конфигураций 1С, которое добавляет к ним MCP серверы и позволяет делать свои инструменты (tools), которые могут вызывать любые нейросетевые модели.

12000 руб.

10.07.2025    2632    4    3    

9
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. artbear 1571 26.08.25 12:37 Сейчас в теме
и в чем будет помощь от этого мцп-сервера?
Курсор, CLine и т.п. сами умеют работать с текстом модулей
2. xamass 7 26.08.25 12:50 Сейчас в теме
(1) Я начал делать этот сервер, как раз потому что попробовал в Cursor сделать анализ ключевых переходов при запуске регламентной процедуры и AI выдал несколько иной результат от того что я ожидал увидеть:
- включил в выдачу процедуры не относящиеся к тем что описаны в нужной процедуре;
- придумал пару новых и тоже добавил их к выдаче.
С этим сервером все отработало так как я ожидал.

PS. Конечно может быть я изначально что-то не так настроил в самой IDE, т.к. сам только начал разбираться в этой теме.
Для отправки сообщения требуется регистрация/авторизация