Mcp 1c

mcp-1c

AI アシスタントと 1С:Предприятие を連携する MCP サーバー

AI が設定のメタデータを参照し、正確な 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 ₽）。8 つの統合ツール（action パラメーターで操作）：モジュールのソースコードの読み取り、XSD スキーマの操作と XML の検証、クエリー最適化ツール、BSL リンター、構文アシスタント、複数データベース対応、.cfe 拡張機能、コードサンドボックス、プロジェクトメモリ、テンプレート
• プロフェッショナル版（月額 4 990 ₽）。拡張版の全機能に加え、コードベース全体の詳細分析、コードナビゲーションと依存関係グラフ、セマンティック検索、アーキテクチャの可視化、自動ドキュメント生成、テストと .epf 処理の生成、標準構成のナビゲーション、データベースと拡張機能の比較、クエリーとプラットフォーム API の検証、RLS 権限とデータ交換計画の分析

登録すると、プロフェッショナル版を 14 日間無料でご利用いただけます。

→ 料金プランの詳細 → ドキュメント

ヒント

プロフェッショナル版のベータテスト。 コードベース全体の詳細分析に対応したプロフェッショナル版を公開しました。大量分析（アンチパターン、重複、デッドコード、セキュリティ監査、品質メトリクス）、コードナビゲーションと依存関係グラフ、セマンティック検索、アーキテクチャの可視化、自動ドキュメント生成、テスト（YAxUnit、Vanessa-Automation）と .epf 処理の生成、標準構成のナビゲーション、データベースと拡張機能の比較、クエリーとプラットフォーム API の検証、RLS 権限とデータ交換計画の分析に対応しています。

登録すると、14 日間無料でご利用いただけます。有益なフィードバックを共有し、テストの継続を希望するアクティブなベータテスターには、試用期間を延長します。ベータテスター上位 5 名には、プロフェッショナル版の永久無料サブスクリプションを進呈します。

→ 登録する | Pro ドキュメント | 問題を報告する

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

	Открытая	Расширенная	Профессиональная
Инструменты	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)

設定

フラグ	Env var	デフォルト	説明
--base	MCP_1C_BASE_URL	http://localhost:8080/hs/mcp-1c	1C HTTPサービスのURL
--user	MCP_1C_USER	-	HTTPサービスのユーザー
--password	MCP_1C_PASSWORD	-	HTTPサービスのパスワード
--max-response-size	MCP_1C_MAX_RESPONSE_SIZE	128	1Cからの応答の最大サイズ（メビバイト、MiB）。これを超える応答は、わかりやすいエラーとともに拒否されます。拡張機能を含む大規模なデータベースでは、上限を引き上げてください。
--request-timeout	MCP_1C_REQUEST_TIMEOUT	300	1CへのHTTPリクエストのタイムアウト（秒）。非常に大きな応答（たとえば、大規模なデータベースの拡張機能）の転送が完了しない場合は、値を大きくしてください。
--dump	-	-	構成のダンプ先パス（DumpConfigToFiles）。ツール search_code と reload_dump を有効にします
--project-root	-	選択した --dump	ローカルファイルツールで使用する既存のプロジェクト。メタデータの読み取りディレクトリとは異なる場合があります
--native-check-platform	-	-	明示的に要求された HELP ビルドに使用する、インストール済みの Designer
--native-check-file-db	-	-	このビルド用のネイティブな合成ファイルデータベース
--native-check-output-root	-	-	HELP の新しい成果物を配置する、既存の専用ディレクトリ。3つの native-check フラグはすべて同時に指定します
--reindex	-	-	検索インデックスを強制的に再構築します（キャッシュを無視）
--install	-	-	指定したパスの1Cデータベースに拡張機能をインストールします
--server	-	-	クライアント・サーバー型データベースモード。--install は接続文字列 サーバー\データベース（例：srv-1c\buh_prod）を受け取ります
--platform	-	-	1Cバイナリへのパス（未指定の場合は自動検出）
--platform-version	-	-	1Cプラットフォームのバージョン（例：8.3.13）。プラットフォームのパスから自動検出されます。バージョン情報を含まない標準外のパスにプラットフォームがインストールされている場合は、手動で指定してください。サポートされる最小バージョン：8.3.10
--db-user	-	-	DESIGNER 用の1Cデータベースユーザー（--install モード）
--db-password	-	-	DESIGNER 用の1Cデータベースパスワード（--install モード）

ログイン名とパスワードは、アドレス内ではなくフラグ --user と --password（または環境変数 MCP_1C_USER と MCP_1C_PASSWORD）で指定してください。 両方を同時に指定してください。--user のみを指定すると、空のパスワードで HTTP Basic 認証が送信されます。http://Admin:secret@сервер/база/hs/mcp-1c の形式も使用できます。mcp-1c は起動時にアドレスから認証情報を取り除き、エラーメッセージやログには記録しません。ただし、? または # を含む場合、ログイン名またはパスワードにキリル文字が含まれる場合、あるいはポートを明示していてパスに @ が含まれる場合は、起動時に拒否されることがあります。詳しくは、--base の HTTP サービスアドレスをご覧ください。

mcp-1c がリダイレクトを実行するのは、--base で指定したアドレスと同じスキーム、ホスト、ポートの範囲内だけです。ウェブサーバーが http から https または別のポートへリダイレクトする場合は、最終的なアドレスを --base に指定してください。

ログと出力

デフォルトの動作は、サーバーがターミナルで起動されたか、MCPクライアント経由で起動されたかによって異なります。

• ターミナルの場合（stdin が tty に接続されている場合）：インデックス作成の進捗、情報メッセージ、エラーは通常どおり stderr に出力されます。
• MCPクライアント経由の場合（Kilo Code、OpenCode、Claude Desktop、Cursor など。stdin が pipe の場合）：stderr は空になり、サードパーティライブラリの予期しない出力は ~/.cache/mcp-1c/stderr.log にリダイレクトされます。これにより、stderr への出力をすべて致命的なエラーとして扱うクライアントを保護します（Issue #14）。

フラグと環境変数

フラグ / env	説明
--verbose	pipe 経由で起動した場合でも、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

これらのシェルは、通常のコンソールハンドルではなく、名前付きパイプを介して 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 ファイルは不要です。

完成済みの MCP_HTTPService.cfe は Releases から入手できます。これは、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 IDEs

MCP-1C は、クライアント側でどのモデルが動作しているかを把握したり、判定したりしません。

1C プラットフォーム	ステータス
8.3.10 以降（商用版）	対応
8.5.x（商用版）	対応
8.3.10+ / 8.5.x（学習版）	対応

サポート対象プラットフォームの最小バージョン：8.3.10

OS	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 です。
• OS とアーキテクチャ。 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