Mcp 1c

mcp-1c

用于将 AI 助手与 1С:Предприятие 集成的 MCP 服务

AI 可以查看您的 1С 配置元数据，并生成准确的 BSL 代码。可与任何兼容 MCP 的客户端配合使用。

支持本地模型

MCP-1C 不依赖特定的神经网络。可与任何兼容 MCP 的客户端配合使用：

• 本地模型（Ollama、LM Studio、llama.cpp）- 数据不会离开您的网络
• 云服务（Claude、GPT、YandexGPT、GigaChat）- 通过相应的 MCP 客户端使用
• 集成 AI 的 IDE（Cursor、VS Code + Continue/Cline、JetBrains）

您的代码和 1С 数据都留在您这里。MCP-1C 是一个本地进程，只与您的数据库通信。

付费版本

除免费的开放版外，还提供具有更多功能的付费版本：

• 扩展版（1 990 ₽/月）。八个整合工具（采用带 action 参数的模型）：读取模块源代码、处理 XSD 架构和验证 XML、查询优化器、BSL 检查器、语法助手、多数据库支持、.cfe 扩展、代码沙箱、项目记忆和模板
• 专业版（4 990 ₽/月）。包含扩展版的所有功能，另有整个代码库的深度分析、代码导航和依赖关系图、语义搜索、架构可视化、自动生成文档、生成测试和 .epf 处理程序、典型配置导航、数据库与扩展比较、查询和平台 API 检查、RLS 权限和交换计划分析

注册后，您可免费使用专业版 14 天。

→ 查看套餐详情 → 文档

提示

专业版 Beta 测试。 我们已推出专业版，支持对整个代码库进行深度分析：批量分析（反模式、重复项、死代码、安全审计、质量指标）、代码导航和依赖关系图、语义搜索、架构可视化、自动生成文档、生成测试（YAxUnit、Vanessa-Automation）和 .epf 处理程序、典型配置导航、数据库与扩展比较、查询和平台 API 检查、RLS 权限和交换计划分析。

注册即可免费使用 14 天。积极参与 Beta 测试、分享有用反馈并希望继续测试的用户，可延长试用期。前 5 名 Beta 测试用户将永久免费获得专业版订阅。

→ 立即注册 | 专业版文档 | 报告问题

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

	Открытая	Расширенная	Профессиональная
Инструменты	19 отдельных (17 без индекса кода)	8 консолидированных	8 + инструменты Pro
Цена	Бесплатно	1 990 ₽/мес	4 990 ₽/мес
Пробный период	-	-	14 дней
Лицензия	MIT	Подписка	Подписка

Расширенная добавляет (8 консолидированных инструментов):

• Чтение исходного кода модулей: объекты, формы, общие модули, расширения
• Сжатый контекст метаданных и резолв имён объектов по индексу выгрузки
• Работа со схемами XSD и структурная проверка XML по реальной выгрузке
• Оптимизатор запросов (15 антипаттернов) и линтер BSL (30+ диагностик)
• Синтакс-помощник (10 000+ определений) и проверка совместимости версий
• Генераторы запросов и печатных форм, конвертер модальных вызовов в асинхронные
• Песочница кода с подтверждением и аудит-логом
• Мультибазовость и работа с расширениями .cfe (чтение, поиск)
• Память проекта (memory) и библиотека шаблонов кода (templates)
• Работа через реверс-опрос (long polling): фоновое регламентное задание в 1С само опрашивает сервер, публиковать HTTP-сервис на веб-сервере не нужно

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

• Массовый анализ всей кодовой базы (bulk_analyze): антипаттерны, дубли, мёртвый код, аудит безопасности BSL, метрики качества, тренды
• Семантический поиск по коду (LSA + Randomized SVD) и гибридный режим
• Навигация по коду и граф зависимостей: иерархия вызовов, переход к объявлению, поиск мест вызова, анализ архитектурных границ, структурные запросы к графу
• Досье объекта и чтение схем компоновки данных (СКД) отчётов
• Архитектурная визуализация (диаграммы) и автогенерация документации
• Генерация тестов (YAxUnit, Vanessa-Automation) и .epf-обработок
• Навигация по типовым конфигурациям (БП, ЗУП, УТ, Розница, КА, ERP)
• Структурный diff расширений .cfe и сверка основной конфигурации с расширением (code_review)
• Помощник по обновлению типовых конфигураций
• Семантическая проверка запросов по метаданным и проверка API платформы в коде BSL
• Разбор прав и RLS ролей, а также планов обмена (офлайн, по выгрузке)
• CI/CD интеграция (--ci, --json, quality gates), отчёты HTML/PDF/SARIF

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

Почему mcp-1c

• Один бинарник, ноль зависимостей. Написан на Go - не нужен Python, Node.js, JVM или EDT. Скачал, запустил, работает.
• 19 инструментов для базы и локальных файлов. Метаданные, запросы к данным, поиск по коду, журнал регистрации и локальные помощники. Без индекса кода доступны 17: search_code и reload_dump требуют --dump.
• Полнотекстовый поиск по коду (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

Этой сборке нужно расширение версии 0.4.10 или новее. Более старое запуску не мешает: сервер работает, но пишет в журнал Extension is OLDER than this build requires, и часть инструментов будет отвечать ошибкой.

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

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

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

Конфигурация MCP-сервера:

{
  "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, Codex, Cursor, Windsurf, VS Code + Copilot, VS Code + Continue, JetBrains IDE, а также любые клиенты для локальных моделей с поддержкой MCP. Настройка каждого - в пошаговой инструкции.

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

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

Локальные form_patterns, register_schema, image_grid и help_add описаны в справке локальных инструментов. Файловые операции используют явно выбранный --project-root (либо --dump) и работают без индекса кода.

Инструмент	Описание
get_metadata_tree	Дерево метаданных: справочники, документы, регистры, определяемые типы, общие модули и др.
get_object_structure	Реквизиты, табличные части, измерения, ресурсы и структура подсистемы (object_type=Subsystem) конкретного объекта
get_form_structure	Структура формы: элементы, команды, обработчики событий. Полный состав читается из выгрузки, поэтому нужен запуск с --dump; без него возвращается только то, что отдал HTTP-сервис 1С, и форму он выбирает сам
get_configuration_info	Имя конфигурации, версия, поставщик, версия платформы, режим работы
get_storage_structure	Таблицы, колонки и индексы СУБД, в которых хранится объект: соответствие _Reference123 и _Fld456 справочникам и реквизитам (ПолучитьСтруктуруХраненияБазыДанных)
count_records	Число доступных пользователю записей выбранного справочника или документа, с типизированными фильтрами периода и организации
metadata_summary	Краткая сводка XML конфигурации, объекта или подсистемы из выбранного --dump, без индекса кода
environment_passport	Безопасная сводка конфигурации, версий и объявленного транспорта с отдельным статусом каждого источника
form_patterns	Статический справочник компоновки управляемых форм
register_schema	Локальная регистрация предоставленного XSD: версия, происхождение и точный SHA-256; без загрузки и валидации XML
image_grid	Отдельный PNG с нумерованной сеткой поверх PNG/JPEG, без изменения оригинала
help_add	Два файла русской справки выбранного внешнего объекта; необязательная явно настроенная сборка через Designer без запуска объекта
search_code	Полнотекстовый поиск по коду модулей: smart (BM25), regex, exact. BSL-синонимы (рус↔англ). Фильтрация по типу метаданных и модуля
reload_dump	Перечитать выгрузку без перезапуска сервера: после повторной выгрузки конфигурации search_code начинает искать по новому содержимому. Доступен только с --dump
bsl_syntax_help	Справка по 180 встроенным функциям, методам типов и паттернам BSL
execute_query	Выполнить запрос на языке запросов 1С с параметрами (только SELECT/ВЫБРАТЬ)
validate_query	Проверить синтаксис запроса без выполнения
get_event_log	Чтение журнала регистрации с фильтрацией по дате, уровню, пользователю и событию
analyze_subsystems	Анализ распределения объектов по подсистемам: объекты вне подсистем (orphans), подсистемы указанного объекта (containing), объекты в нескольких подсистемах (intersections)

配置

标志	环境变量	默认值	描述
--base	MCP_1C_BASE_URL	http://localhost:8080/hs/mcp-1c	1С HTTP 服务的 URL
--user	MCP_1C_USER	-	HTTP 服务用户
--password	MCP_1C_PASSWORD	-	HTTP 服务密码
--max-response-size	MCP_1C_MAX_RESPONSE_SIZE	128	1С 响应的最大大小，单位为 MiB。超过此大小的响应将被拒绝，并显示易于理解的错误信息。对于包含扩展的大型数据库，请提高此限制。
--request-timeout	MCP_1C_REQUEST_TIMEOUT	300	对 1С 发起的 HTTP 请求超时时间，单位为秒。如果传输非常大的响应（例如大型数据库的扩展）无法及时完成，请提高此值。
--dump	-	-	配置导出的路径（DumpConfigToFiles），启用工具 search_code 和 reload_dump
--project-root	-	所选的 --dump	用于本地文件工具的现有项目；可以与读取元数据的目录不同
--native-check-platform	-	-	用于显式请求的 HELP 构建的已安装 Designer
--native-check-file-db	-	-	用于此构建的原生合成文件数据库
--native-check-output-root	-	-	用于新 HELP 构建产物的现有独立目录；必须同时指定全部三个 native-check 标志
--reindex	-	-	强制重建搜索索引（忽略缓存）
--install	-	-	将扩展安装到指定路径的 1С 数据库中
--server	-	-	客户端-服务器数据库模式：--install 接受连接字符串 服务器\数据库（例如 srv-1c\buh_prod）
--platform	-	-	1С 二进制文件的路径（如果未指定，则自动检测）
--platform-version	-	-	1С 平台版本（例如 8.3.13）。根据平台路径自动检测。如果平台安装在不包含版本信息的非标准路径中，请手动指定。支持的最低版本：8.3.10
--db-user	-	-	DESIGNER 使用的 1С 数据库用户（--install 模式）
--db-password	-	-	DESIGNER 使用的 1С 数据库密码（--install 模式）

请通过 --user 和 --password 标志（或 MCP_1C_USER 和 MCP_1C_PASSWORD 环境变量）传递登录名和密码，而不要将其写入地址中。 请同时指定二者：仅使用 --user 而不指定 --password 时，将发送密码为空的 HTTP Basic 认证。http://Admin:secret@服务器/数据库/hs/mcp-1c 这种写法也有效；mcp-1c 会在启动时从地址中移除凭据，不会将其写入错误消息或日志。但部分此类地址会在启动时被拒绝：包含 ? 或 #、登录名或密码中包含俄文字母，以及显式指定端口时路径中包含 @。完整说明：--base 中的 HTTP 服务地址。

mcp-1c 仅会在 --base 指定的地址范围内跟随重定向：协议、主机和端口都必须相同。如果 Web 服务器将 http 重定向到 https 或其他端口，请在 --base 中指定最终地址。

日志记录和输出

默认行为取决于服务器是在终端中运行，还是通过 MCP 客户端启动：

• 在终端中（stdin 连接到 tty）：索引进度、信息消息和错误照常写入 stderr。
• 通过 MCP 客户端（Kilo Code、OpenCode、Claude Desktop、Cursor 等；stdin 为管道时）：stderr 为空，第三方库的意外输出会被重定向到 ~/.cache/mcp-1c/stderr.log。这可以保护那些将任何 stderr 输出视为致命错误的客户端（Issue #14）。

标志和环境变量

标志 / 环境变量	描述
--verbose	即使通过管道启动，也强制启用 stderr。便于调试 MCP 客户端连接。
--quiet	即使在终端中，也强制静默 stderr。优先级高于 --verbose。
MCP_1C_NO_TTY=1	等同于 --quiet。在 Docker / systemd 中启动时，命令行参数不够灵活，使用此方式比 CLI 标志更方便。
--debug	将详细日志写入文件 ~/.cache/mcp-1c/server.log。在终端中也会禁用进度指示器。

Windows 上的 Git Bash / MSYS2 / MinTTY

这些 Shell 通过命名管道而非普通控制台句柄连接 stdin。自动检测会将它们判定为非 TTY，因此默认不会显示索引进度。手动诊断时，请使用 --verbose 标志或完整的 cmd.exe / Windows Terminal。

开发

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

1C 扩展

扩展源代码以配置 XML 导出格式存储在 extension/src/ 中。使用 --install 时，源代码会通过 go:embed 嵌入二进制文件，并通过 DESIGNER /LoadConfigFromFiles 直接加载。无需准备好 .cfe 文件即可构建。

可在 Releases 获取已构建的 MCP_HTTPService.cfe。如果无法访问 1C 服务器上的命令行（例如通过 RDP 操作），这是最简单的安装方式。详情请参阅：docs/1c-setup.md。

手动从源代码构建 .cfe：

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

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

兼容性

AI 客户端
本地模型	Ollama、LM Studio、llama.cpp 及任何兼容 MCP 的客户端
云服务	Claude Desktop、Claude Code、Codex、GPT（通过 MCP 客户端）、YandexGPT、GigaChat
IDE	Cursor、VS Code（Continue、Cline、Copilot）、Windsurf、JetBrains IDE

MCP-1C 不知道也不会判断客户端运行的是哪种模型。

1C 平台	状态
8.3.10 及以上（商业版）	支持
8.5.x（商业版）	支持
8.3.10+ / 8.5.x（教育版）	支持

支持的最低平台版本：8.3.10

操作系统	MCP 服务	自动安装	1C HTTP 服务
Windows	是	是	是（Apache 或 IIS）
macOS	是	是	否（1C 平台限制），请使用 Windows-VM
Linux	是	是	是（Apache 或 ibsrv）

系统要求

服务本身对资源要求不高。只有在运行本地模型时才需要高性能硬件，而硬件要求由模型本身决定，与 MCP-1C 无关。

MCP-1C 服务：

• 二进制文件。 单个静态可执行文件，无依赖（不需要 Python、Node.js、JVM 或 EDT）。大小约为 25-40 MB。
• 操作系统和架构。 Windows、macOS、Linux；amd64 和 arm64。
• 1C 平台。 支持的最低版本为 8.3.10。手动安装已构建的 .cfe 需要 8.3.14 或更高版本。
• 数据访问。 1C HTTP 服务或离线配置导出（--dump）。
• CPU 和 RAM。 要求极低，没有固定的最低配置。构建搜索索引时，内存占用受架构限制：数据会分批处理并流式写入磁盘。
• 磁盘。 大型配置（БСП、ERP、УТ）的搜索索引缓存约为 100-200 MB。为 13,000 多个模块构建索引约需 7 秒；后续运行会使用缓存。

模型（LLM）：

MCP-1C 不会启动或托管任何模型。它可以与客户端上的任何模型配合使用，因此模型的硬件要求取决于您的选择：

• 云模型（Claude、GPT、YandexGPT、GigaChat）：本地硬件无特殊要求。
• 本地模型（Ollama、LM Studio、llama.cpp）：RAM、VRAM 和磁盘要求由所选模型决定，与 MCP-1C 无关。

Публикации

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

Лицензия

MIT