mcp-1c

MCP-сервер для интеграции AI-ассистентов с 1С:Предприятие.

AI видит метаданные вашей конфигурации 1С и генерирует точный код на BSL. Работает с любым MCP-совместимым клиентом.

Открытая и Расширенная версии

	Открытая (этот репозиторий)	Расширенная
Инструменты	9	9 + 15 = 24
Цена	Бесплатно, MIT	1 990 руб./мес
Пробный период	-	14 дней

Что добавляет Расширенная версия:

• Оптимизатор запросов (15 антипаттернов)
• Линтер BSL (30 диагностик, коды BSL001-BSL030)
• Полный справочник синтаксиса платформы (~10 000 определений)
• Чтение и поиск по коду расширений (.cfe)
• Long polling - работа без Apache/IIS
• Анализ структуры модулей (зависимости, побочные эффекты, запросы)
• Проверка совместимости между версиями платформы
• Конвертер модальных вызовов в асинхронные
• Генератор запросов и печатных форм
• Песочница для безопасного выполнения кода
• Мультибазовость (несколько баз в одном сеансе)
• Умный контекст (экономия токенов)

Регистрация и загрузка: feenlace.ru

Почему mcp-1c

• Один бинарник, ноль зависимостей. Написан на Go — не нужен Python, Node.js, JVM или EDT. Скачал, запустил, работает.
• 9 инструментов для работы с живой базой. Метаданные, информация о конфигурации, формы, запросы к данным (с параметрами), поиск по коду, валидация, журнал регистрации, справка BSL.
• Полнотекстовый поиск по коду (search_code). Три режима: smart (BM25-ранжирование), regex, exact. Встроенные BSL-синонимы — поиск по StrFind находит СтрНайти и наоборот.
• Шардированная индексация. Параллельная сборка индекса по числу ядер. ~7 сек для 13 000+ модулей. Дисковый кеш — повторный запуск мгновенный.
• Неблокирующий старт. Индекс строится в фоне, MCP-сервер доступен сразу. Поиск заработает после завершения индексации.
• Работает с вашей базой. AI видит реальную конфигурацию и реальные данные — не абстрактную справку, а именно вашу базу.
• Не привязан к IDE. Работает с Конфигуратором, EDT, или вообще без IDE — нужен только HTTP-сервис 1С.
• Автоустановка. mcp-1c --install "C:\путь\к\базе" — сам найдёт платформу, поставит расширение, обновит конфигурацию БД.
• Встроенная справка BSL. Синтаксис функций платформы доступен без внешних сервисов и без запущенной 1С.

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

Впервые слышите про MCP? Читайте пошаговую инструкцию — там всё с нуля, включая объяснение что такое MCP.

1. Скачать

Бинарник для вашей ОС — в Releases. Или: go build -o mcp-1c ./cmd/mcp-1c/

2. Установить расширение в 1С

# Windows
mcp-1c --install "C:\путь\к\базе"

# macOS / Linux
mcp-1c --install ~/Documents/InfoBase

# Клиент-серверная база (MS SQL, PostgreSQL)
mcp-1c --install "srv-1c\buh_prod" --server --db-user Admin --db-password pass

Если платформа установлена в нестандартную папку: mcp-1c --install "путь" --platform "/custom/path/to/1cv8"

3. Запустить HTTP-сервис 1С

Рекомендуемый способ — стандартная публикация через Apache или IIS (Конфигуратор → Администрирование → Публикация на веб-сервере). Работает на Windows и Linux. Подробности — в пошаговой инструкции.

Быстрый запуск для разработки (только Windows):

"C:\Program Files\1cv8\8.3.XX.XXXX\bin\1cv8.exe" ENTERPRISE /F "C:\путь\к\базе" /HTTPPort 8080

Параметр /HTTPPort — недокументированный, работает только на Windows и подходит для быстрой проверки. На Linux используйте Apache или ibsrv, на macOS HTTP-сервисы 1С не поддерживаются.

4. Настроить AI-клиент

Пример для Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "1c": {
      "command": "C:\\путь\\к\\mcp-1c.exe",
      "args": ["--base", "http://localhost:8080/hs/mcp"]
    }
  }
}

Перезапустите AI-клиент. В Claude Desktop рекомендуем: «+» → Connectors → Tool access → Always available.

Также поддерживаются: Claude Code, Cursor, Windsurf, VS Code + Copilot, VS Code + Continue, JetBrains IDE. Настройка каждого — в пошаговой инструкции.

Спросите: «Покажи структуру конфигурации моей базы 1С»

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

Инструмент	Описание
get_metadata_tree	Дерево метаданных: справочники, документы, регистры, общие модули и др.
get_object_structure	Реквизиты, табличные части, измерения и ресурсы конкретного объекта
get_form_structure	Структура основной формы: элементы, команды, обработчики событий
execute_query	Выполнить запрос на языке запросов 1С с параметрами (только SELECT/ВЫБРАТЬ)
validate_query	Проверить синтаксис запроса без выполнения
search_code	Полнотекстовый поиск по коду модулей: smart (BM25), regex, exact. BSL-синонимы (рус↔англ). Фильтрация по типу метаданных и модуля
get_event_log	Чтение журнала регистрации с фильтрацией по дате, уровню и пользователю
get_configuration_info	Имя конфигурации, версия, поставщик, версия платформы, режим работы
bsl_syntax_help	Справка по 180 встроенным функциям, методам типов и паттернам BSL

Конфигурация

Флаг	Env var	По умолчанию	Описание
--base	MCP_1C_BASE_URL	http://localhost:8080/hs/mcp	URL HTTP-сервиса 1С
--user	MCP_1C_USER	—	Пользователь HTTP-сервиса
--password	MCP_1C_PASSWORD	—	Пароль HTTP-сервиса
--dump	—	—	Путь к выгрузке конфигурации (DumpConfigToFiles), включает инструмент search_code
--reindex	—	—	Принудительная перестройка поискового индекса (игнорирует кеш)
--install	—	—	Установить расширение в базу 1С по указанному пути
--server	—	—	Режим клиент-серверной базы: --install принимает строку подключения сервер\база (например srv-1c\buh_prod)
--platform	—	—	Путь к бинарнику 1С (автоопределение, если не указан)
--db-user	—	—	Пользователь базы 1С для DESIGNER (режим --install)
--db-password	—	—	Пароль базы 1С для DESIGNER (режим --install)

Разработка

go build -o mcp-1c ./cmd/mcp-1c         # сборка
go test ./... -v -race                    # тесты
go run ./cmd/mock-1c -port 9191           # mock-сервер 1С

Расширение 1С

Исходники расширения хранятся в extension/src/ в формате XML-выгрузки конфигурации. При --install они встроены в бинарник через go:embed и загружаются напрямую через DESIGNER /LoadConfigFromFiles. Готовый .cfe файл для сборки не требуется.

Для ручной установки без CLI можно собрать .cfe из исходников:

# macOS / Linux (требуется установленная платформа 1С)
./scripts/build-extension.sh ~/Documents/InfoBase

# Windows
scripts\build-extension.cmd C:\Users\User\Documents\InfoBase

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

Платформа 1С	Статус
8.3.x (коммерческая)	Поддерживается
8.5.x (коммерческая)	Поддерживается
8.3.x / 8.5.x (учебная)	Поддерживается

ОС	MCP-сервер	Автоустановка	HTTP-сервис 1С
Windows	да	да	да (Apache/IIS — рекомендуется, /HTTPPort — для быстрого запуска)
macOS	да	да	нет (ограничение платформы 1С), используйте Windows-VM
Linux	да	да	да (Apache или ibsrv; /HTTPPort недоступен)

Публикации

• Один бинарник, ноль зависимостей: подключаем AI к вашей базе 1С за 10 минут

Лицензия

MIT