Skip to content
Back to search

1c_mcp

Инструмент для создания MCP-серверов в 1С:Предприятие путем разработки расширения конфигурации. Позволяет интегрировать данные и функциональность 1С с AI-ассистентами (Claude, Cursor и т.д.). Включает Python-прокси и пример расширения 1С с готовыми инструментами.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vladimir-kharin--1c-mcp/badge.svg)](/listings/vladimir-kharin--1c-mcp)

HTML

<a href="/listings/vladimir-kharin--1c-mcp"><img src="/api/listings/vladimir-kharin--1c-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 130 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Разработка MCP-серверов в 1С
  2. Инструмент для создания MCP (Model Context Protocol) серверов на платформе 1С:Предприятие. Позволяет разрабатывать расширения 1С, которые предоставляют данные и функциональность базы для AI-ассистентов (чаты с языковыми моделями, Claude Desktop, Cursor и других AI-клиентов).
  3. Подробное видео о проекте и его возможностях:
  4. [VK Видео](https://vkvideo.ru/video-219359576_456239024) | [Youtube](https://youtu.be/ZEla85JsfCo) | [Rutube](https://rutube.ru/video/ba1c64432d1a5b6cfd2335b83bf47071/)
  5. Проект содержит готовое расширение для 1С, которое берет на себя всю техническую рутину протокола MCP. Вам остается только реализовать бизнес-логику ваших инструментов. Инструменты для работы с метаданными конфигурации 1С доступны "из коробки".
  6. > **Нужен не конструктор, а готовый сервер?**
  7. >
  8. > Этот репозиторий — **платформа**: на ней разрабатывают свои MCP-серверы для 1С.
  9. > На ней же построен **[Multitool MCP для 1С](https://vharin.ru/info/1c_multitool_mcp/)** — готовый мультитул
  10. > для разработчиков и аналитиков. Агент видит структуру базы, читает любые данные запросами, разбирает журнал
  11. > регистрации и справку платформы. Поддерживает обезличивание: персональные данные не уходят в облачную модель.
  12. > Скачать и подключить — на [странице Multitool](https://vharin.ru/info/1c_multitool_mcp/).
  13. ## Как это работает: Концепция MCP
  14. Качество ответа языковой модели (LLM) напрямую зависит от качества предоставленного ей контекста. Подготовка такого контекста вручную может быть трудоемкой.
  15. **Model Context Protocol (MCP)** — это открытый стандарт, который позволяет модели самой запрашивать необходимые данные через специальные "инструменты" (tools), предоставляемые вашим сервером. Таким образом, контекст для решения задачи собирается автоматически.
  16. ## Компоненты проекта
  17. 1. **`src/1c_ext/`** - **Расширение 1С:** Ядро решения. Реализует MCP-сервер и инструменты.
  18. 2. **`src/py_server/`** - **Python-прокси:** Опциональный, но рекомендуемый компонент для решения инфраструктурных задач.
  19. ## Быстрый старт
  20. ### Шаг 1: Установка расширения 1С
  21. Подключите готовое, собранное расширение из каталога `build/MCP_Сервер.cfe` в вашу конфигурацию.
  22. ### Шаг 2: Публикация HTTP-сервиса
  23. Опубликуйте на веб-сервере HTTP-сервис `mcp_APIBackend`, который находится в расширении.
  24. > **Важно:** Регистр имени базы в URL должен точно совпадать с именем публикации (например, `base`, а не `Base`). Несовпадение регистра приводит к редиректам, которые превращают POST-запросы в GET.
  25. > **Важно:** Для прямого подключения AI-клиента к 1С (без прокси) требуется публиковать базу без необходимости аутентификации ("вшить" реквизиты доступа к базе в default.vrd), что является небезопасным. Решение этой проблемы описано в разделе "Варианты подключения".
  26. ### Шаг 3: Подключение AI-клиента
  27. Подключите MCP-клиент (например, Cursor) к опубликованному HTTP-сервису (`.../ваша_база/hs/mcp/`). Примеры настроек для разных клиентов находятся в папке [`mcp_client_settings/`](./mcp_client_settings/).
  28. ## Варианты подключения
  29. ### Вариант 1: Прямое подключение к 1С
  30. - **Как работает:** `AI-клиент ←→ HTTP-сервис 1С`
  31. - **Ограничения:**
  32. - Требует публикации HTTP-сервиса без аутентификации 1С.
  33. - Невозможно подключить клиенты, требующие транспорт `stdio`.
  34. - Ограниченная совместимость с некоторыми HTTP-клиентами из-за нюансов протокола.
  35. ### Вариант 2: Подключение через Python-прокси (Рекомендуется)
  36. - **Как работает:** `AI-клиент ←→ MCP-прокси (Python) ←→ HTTP-сервис 1С`
  37. - **Зачем он нужен?** Прокси решает ключевые инфраструктурные проблемы:
  38. - **Проблема транспорта:** Позволяет подключать клиенты, работающие по `stdio`.
  39. - **Проблема аутентификации:** Реализует протокол `OAuth2` (стандартный способ аутентификации в MCP) и передает авторизацию в 1С через `Basic Auth`. Это позволяет **не отключать** аутентификацию 1С на веб-сервере. Прокси поддерживает два режима: работа от имени одного фиксированного пользователя или "проброс" аутентификации каждого пользователя под его собственными учетными данными.
  40. - **Настройка и запуск прокси:**
  41. - Детальная инструкция по требованиям, установке, настройке и запуску находится в [документации Python-прокси](./src/py_server/README.md).
  42. ### Вариант 3: Запуск прокси в Docker
  43. Для изолированного запуска прокси-сервера в контейнере:
  44. ```bash
  45. # Скопируйте пример конфигурации
  46. cp .env.docker.example .env
  47. # Отредактируйте .env (укажите URL, логин, пароль)
  48. # Запустите контейнер
  49. docker-compose up -d
  50. ```
  51. > **Важно:** Если 1С на том же хосте, используйте `host.docker.internal` вместо `localhost` в `MCP_ONEC_URL`.
  52. Подробнее в [документации Python-прокси](./src/py_server/README.md#docker).
  53. ## Разработка собственных инструментов
  54. Функциональность расширяется добавлением собственных инструментов для взаимодействия с данными 1С.
  55. ### Вариант 1. Разработка внутри движка
  56. - **Шаг 1:** В расширении создайте новую обработку и включите ее в подсистему `mcp_КонтейнерыИнструментов`.
  57. - **Шаг 2:** В модуле менеджера этой обработки реализуйте два экспортных метода:
  58. ```bsl
  59. // Метод для описания инструментов и их параметров
  60. Процедура ДобавитьИнструменты(Инструменты) Экспорт
  61. // ... здесь вы описываете, какие инструменты предоставляет ваша обработка
  62. КонецПроцедуры
  63. // Метод для выполнения логики инструмента
  64. Функция ВыполнитьИнструмент(ИмяИнструмента, Аргументы) Экспорт
  65. // ... здесь вы реализуете логику, которая будет вызвана AI-моделью
  66. КонецФункции
  67. ```
  68. ### Вариант 2. Разработка в своем расширении
  69. Подход такой же, но можно создать отдельное расширение для своих инструментов. В это отдельное расширение необходимо скопировать подсистему mcp_MCPСервер и добавить к ней префикс своего расширения (Например, МОЙ_mcp_MCPСервер). Движок находит подсистемы, которые в названии содержат mcp_MCPСервер и подключает их идентично своим.
  70. Подробное руководство по разработке находится в файле [`src/1c_ext/agents.md`](./src/1c_ext/agents.md).
  71. ## Другие примитивы MCP
  72. Помимо **Инструментов (Tools)**, проект также поддерживает **Ресурсы (Resources)** для предоставления статического контекста (например, файлов) и **Промпты (Prompts)** для заготовленных шаблонов сообщений.
  73. ## Документация
  74. - **[Документация Python-прокси](./src/py_server/README.md)** — детальное описание настройки и запуска прокси-сервера.
  75. - **[Расширение MCP_Сервер](./src/1c_ext/README.md)** — устройство, подключение, права доступа, компоненты.
  76. - **[Обезличивание данных](./src/1c_ext/anonymization.md)** — подсистема для инструментов, которые выдают данные базы: правила, токены, метки; при включённом обезличивании скрывает инструменты, которые не умеют обезличивать.
  77. - **[Руководство по разработке в 1С](./src/1c_ext/agents.md)** — подробности реализации инструментов, ресурсов и промптов на стороне 1С. Можно подключать к генераторам кода (AI-агентам).
  78. - **[Примеры настроек клиентов](./mcp_client_settings/)** — готовые конфигурации для разных AI-клиентов.
  79. ## Лицензия
  80. MIT License
  81. ## Поддержка и развитие
  82. Проект активно развивается. Вопросы и предложения по улучшению приветствуются через Issues.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.