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
4 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    214283    1178    413    

1050

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

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

17.06.2025    16597    0    Infostart    20    

113

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

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

8400 руб.

20.08.2024    41241    225    117    

213

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

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

22200 руб.

06.10.2023    26892    68    30    

98

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

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

16000 руб.

10.11.2023    19023    76    39    

92

Инструментарий разработчика Программист 1С v8.3 Платные (руб)

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

9500 руб.

17.05.2024    38109    135    55    

177

Нейросети Пользователь 1С v8.3 1С:Управление нашей фирмой 1.6 1С:Управление торговлей 11 1С:Управление нашей фирмой 3.0 Оптовая торговля, дистрибуция, логистика Россия Управленческий учет Платные (руб)

Расширение "Искусственный интеллект и нейросети в 1С: Работа с отзывами маркетплейсов" предназначено для применения искусственного интеллекта в повседневной деятельности селлеров на маркетплейсах. Среди функций - работа с отзывами, вопросами и чатами покупателей, диалог с нейросетями, генерация картинок, заполнение описаний номенклатуры и другое.

6000 руб.

03.04.2024    10582    6    0    

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

PS. Конечно может быть я изначально что-то не так настроил в самой IDE, т.к. сам только начал разбираться в этой теме.
FSerg; artbear; +2 Ответить
4. user958854 08.09.25 17:17 Сейчас в теме
(2)
AI выдал несколько иной результат от того что я ожидал увидеть:

Это частично объясняется здесь: https://gist.github.com/mcowger/892fb83ca3bbaf4cdc7a9f2d7c45b081#file-rules-md
3. user958854 08.09.25 17:13 Сейчас в теме
На заметку. Курсор и так быстро, при необходимости, просматривает тексты модулей (проиндексированного самим Курсором) проекта.
Для отправки сообщения требуется регистрация/авторизация