INFATON MCP Server для 1С:Предприятие

Model Context Protocol (MCP) — сервер на стороне 1С:Предприятие, предоставляющий 35 инструментов для взаимодействия AI-ассистентов с базой данных 1С.

Протокол: JSON-RPC 2.0 (спецификация MCP)

📋 Состав репозитория

Файл	Описание
`Module.bsl`	Модуль HTTP-сервиса MCP — основной код 35 инструментов
`INFATON_MCP.cfe`	Расширение конфигурации 1С (готовый бинарный пакет)
`HOW_TO_BUILD_CFE.md`	Инструкция по сборке и установке `.cfe`

🛠 35 инструментов

Метаданные (8)

#	Инструмент	Описание
1	`get_metadata_tree`	Дерево объектов метаданных конфигурации
2	`get_object_metadata`	Полная структура объекта (реквизиты, ТЧ, модули)
3	`get_object_attributes`	Список реквизитов объекта
4	`get_object_tabular_sections`	Табличные части объекта
5	`get_enum_values`	Значения перечисления
6	`get_register_dimensions`	Измерения, ресурсы и реквизиты регистра
7	`get_document_movements`	Движения документа по регистрам
8	`search_metadata`	Поиск по метаданным (по имени/синониму)

Данные (7)

#	Инструмент	Описание
9	`execute_query`	Выполнение произвольного запроса 1С
10	`get_object_by_ref`	Получение объекта по ссылке/GUID
11	`get_list`	Список элементов справочника/документа с фильтрами
12	`find_by_code`	Поиск по коду
13	`find_by_name`	Поиск по наименованию
14	`get_register_records`	Записи регистра с фильтрами
15	`get_document_list`	Список документов с фильтрами по дате/номеру

CRUD (7)

#	Инструмент	Описание
16	`create_object`	Создание нового объекта (справочник/документ)
17	`update_object`	Изменение реквизитов объекта
18	`delete_object`	Пометка на удаление
19	`post_document`	Проведение документа
20	`unpost_document`	Отмена проведения
21	`copy_object`	Копирование объекта
22	`set_attribute`	Изменение отдельного реквизита

Код и вычисления (3)

#	Инструмент	Описание
23	`execute_code`	Выполнение произвольного кода 1С
24	`evaluate_expression`	Вычисление выражения
25	`get_module_text`	Получение текста модуля объекта

Отчёты (1)

#	Инструмент	Описание
26	`generate_report`	Формирование отчёта (СКД)

Администрирование (4)

#	Инструмент	Описание
27	`get_active_users`	Список активных пользователей
28	`get_event_log`	Журнал регистрации
29	`get_locks`	Блокировки данных
30	`get_server_info`	Информация о сервере 1С

Проверки и контроль (2)

#	Инструмент	Описание
31	`check_references`	Проверка ссылочной целостности
32	`run_scheduled_job`	Запуск регламентного задания

Обмен данными (3)

#	Инструмент	Описание
33	`exchange_execute`	Выполнение обмена данными
34	`get_exchange_log`	Журнал обмена
35	`import_data`	Импорт данных из JSON

🚀 Быстрый старт

1. Установка расширения

Откройте Конфигуратор базы 1С
Конфигурация → Расширения конфигурации → Добавить
Выберите файл INFATON_MCP.cfe
Обновите конфигурацию БД (F7)

2. Проверка

curl -u 'Логин:Пароль' -X POST \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1}' \
  https://ваш-сервер/база/hs/mcp/

Ожидаемый ответ:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": { "tools": {} },
    "serverInfo": { "name": "infaton-1c-mcp", "version": "1.0.0" }
  }
}

3. Вызов инструмента

curl -u 'Логин:Пароль' -X POST \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":2,"params":{"name":"get_metadata_tree","arguments":{}}}' \
  https://ваш-сервер/база/hs/mcp/

📐 Архитектура

┌─────────────────────────┐
│   AI Assistant          │  Claude / GPT / Qwen / ...
│   (MCP Client)          │
└────────┬────────────────┘
         │ JSON-RPC 2.0
         ▼
┌─────────────────────────┐
│   HTTP-сервис /hs/mcp/  │  Расширение INFATON_MCP.cfe
│   Module.bsl            │  35 инструментов
│   (MCP Server)          │
└────────┬────────────────┘
         │ Встроенный язык 1С
         ▼
┌─────────────────────────┐
│   База 1С:Предприятие   │  ERP / УПП / Бухгалтерия / ...
│   Данные, метаданные    │
└─────────────────────────┘

📝 Совместимость

Платформа 1С: 8.3.20+ (тестировалось на 8.3.27)
Конфигурации: ERP 2.5, УПП 1.3, Бухгалтерия 3.0, УТ 11, КА 2
MCP Протокол: 2024-11-05
Транспорт: HTTP (Basic Auth)

📄 Лицензия

Подробная инструкция по сборке .cfe — см. HOW_TO_BUILD_CFE.md

INFATON MCP35