mcp-1c

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

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

Работает с локальными моделями

MCP-1C не привязан к конкретной нейросети. Работает с любым MCP-совместимым клиентом:

• Локальные модели (Ollama, LM Studio, llama.cpp) - данные не покидают вашу сеть
• Облачные сервисы (Claude, GPT, YandexGPT, GigaChat) - через соответствующие MCP-клиенты
• IDE с AI (Cursor, VS Code + Continue/Cline, JetBrains)

Ваш код и данные 1С остаются у вас. MCP-1C - это локальный процесс, который общается только с вашей базой.

Платные версии

Помимо бесплатной Открытой версии, доступны платные редакции с расширенными возможностями:

• Расширенная (1 990 ₽/мес) — 7 инструментов: оптимизатор запросов, линтер BSL, синтакс-помощник, мультибазовость, расширения .cfe и другие
• Профессиональная (4 990 ₽/мес) — всё из Расширенной плюс: семантический поиск, граф зависимостей, массовый анализ кода, аудит безопасности, метрики кодовой базы, помощник по обновлению типовых

При регистрации вы получаете 14 дней Профессиональной версии бесплатно.

→ Подробнее о тарифах → Документация

[!TIP] Бета-тест Профессиональной версии. Мы запустили Профессиональную редакцию с 6 инструментами для глубокого анализа кодовой базы: семантический поиск, граф зависимостей, массовый анализ, аудит безопасности, метрики качества и помощник по обновлению типовых.

Зарегистрируйтесь и получите 14 дней бесплатно. Активным бета-тестерам, которые делятся полезной обратной связью и хотят продолжить тестирование, продлеваем пробный период. Топ-5 бета-тестеров получат бесплатную подписку навсегда на Профессиональную версию.

→ Зарегистрироваться | Документация Pro | Сообщить о проблеме

Сравнение версий

| | Открытая | Расширенная | Профессиональная | |---|---|---|---| | Инструменты | 9 | 7 | 7 + bulk_analyze | | Цена | Бесплатно | 1 990 ₽/мес | 4 990 ₽/мес | | Пробный период | — | — | 14 дней | | Лицензия | MIT | Подписка | Подписка |

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

• Оптимизатор запросов (15 антипаттернов)
• Линтер BSL (30+ диагностик)
• Синтакс-помощник (10 000+ определений)
• Мультибазовость и расширения .cfe
• Песочница кода, генератор запросов и печатных форм
• Конвертер модальных вызовов в асинхронные
• Умный контекст и автообновление данных

Профессиональная добавляет:

• Семантический поиск по коду (LSA + Randomized SVD)
• Граф зависимостей модулей (10 типов связей, SQLite)
• Массовый анализ кода (антипаттерны, дубли, мёртвый код)
• Аудит безопасности BSL (11 правил SEC)
• Метрики кодовой базы (LOC, сложность, техдолг 0-100)
• Помощник по обновлению типовых (3-way diff)
• CI/CD интеграция (--ci, --json, quality gates)
• HTML/PDF отчёты

→ Зарегистрироваться | Тарифы

Почему 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. Работает с любой моделью, включая локальные (Ollama, LM Studio). Нужен только 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"

Если версия платформы не определяется автоматически (нестандартный путь без номера версии), укажите её явно: mcp-1c --install "путь" --platform "/custom/path/to/1cv8" --platform-version 8.3.13

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-клиент

Конфигурация MCP-сервера одинакова для любого клиента и любой модели. Не важно, используете вы Claude, Ollama или LM Studio, настройка MCP-1C не меняется:

{
  "mcpServers": {
    "1c": {
      "command": "/path/to/mcp-1c",
      "args": ["--base", "http://localhost:8080/hs/mcp-1c"]
    }
  }
}

На Windows пути с обратными слешами: "command": "C:\\путь\\к\\mcp-1c.exe"

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

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

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

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

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

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

| Флаг | Env var | По умолчанию | Описание | |------|---------|-------------|----------| | --base | MCP_1C_BASE_URL | http://localhost:8080/hs/mcp-1c | 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С (автоопределение, если не указан) | | --platform-version | — | — | Версия платформы 1С (например 8.3.13). Определяется автоматически из пути к платформе. Укажите вручную, если платформа установлена в нестандартный путь без информации о версии. Минимальная поддерживаемая версия: 8.3.10 | | --db-user | — | — | Пользователь базы 1С для DESIGNER (режим --install) | | --db-password | — | — | Пароль базы 1С для DESIGNER (режим --install) |

Логирование и вывод

По умолчанию поведение зависит от того, запущен ли сервер в терминале или через MCP-клиент:

• В терминале (stdin подключён к tty): прогресс индексации, информационные сообщения и ошибки пишутся в stderr как обычно.
• Через MCP-клиент (Kilo Code, OpenCode, Claude Desktop, Cursor и др., когда stdin это pipe): stderr пустой, случайный вывод сторонних библиотек перенаправляется в ~/.cache/mcp-1c/stderr.log. Это защищает клиентов, которые трактуют любой stderr-вывод как фатальную ошибку (Issue #14).

Флаги и переменные окружения

| Флаг / env | Описание | |------------|---------| | --verbose | Принудительно включить stderr даже при запуске через pipe. Удобно для отладки подключения MCP-клиента. | | --quiet | Принудительно заглушить stderr даже в терминале. Переопределяет --verbose. | | MCP_1C_NO_TTY=1 | Эквивалент --quiet. Удобнее CLI-фла