1c-mcp-server

MCP-сервер для анализа дампа конфигурации 1С (выгрузка в файлы XML): метаданные объектов, поиск использований в BSL и формах, чтение фрагментов модулей и связанные операции. Работает через транспорт STDIO (типичный сценарий для Cursor и других MCP-клиентов) или HTTP (streamable MCP с опциональной авторизацией).

Автор: Stanislav Shulich · Лицензия: MIT

Возможности

Инструменты MCP (основные):

Поверх данных строится индекс для BSL/XML; при старте возможна фоновая пересборка индексов.

Требования

• Go не ниже 1.25.9 (рекомендуется последний патч ветки 1.25).
• Каталог дампа конфигурации 1С — папка, в которой есть файл Configuration.xml (типичная выгрузка конфигурации в файлы).

Установка

go install github.com/Sshulich/1c-mcp-server@latest

Сборка из исходников:

git clone https://github.com/Sshulich/1c-mcp-server.git
cd 1c-mcp-server
go build -ldflags "-X main.version=1.0.0 -X main.commit=$(git rev-parse --short HEAD)" -o 1c-mcp-server .

Важно: переменная CONFIG_DUMP_DIR должна указывать на корень дампа до запуска бинарника (см. ниже).

Обязательная настройка: дамп конфигурации

Сервер читает метаданные только с диска. Задайте каталог выгрузки:

# Windows (PowerShell)
$env:CONFIG_DUMP_DIR = "D:\dump\MyConfig"

# Linux / macOS
export CONFIG_DUMP_DIR=/path/to/configuration/dump

В этом каталоге должен находиться Configuration.xml. При необходимости подхватываются расширения конфигурации, обнаруженные рядом с дампом.

Режимы транспорта

STDIO (по умолчанию)

Подходит для встраивания в IDE. Пример переменных:

export CONFIG_DUMP_DIR=/path/to/dump
./1c-mcp-server
# или явно:
export MCP_TRANSPORT=stdio

HTTP

Streamable HTTP MCP (по умолчанию слушает :8080):

export CONFIG_DUMP_DIR=/path/to/dump
export MCP_TRANSPORT=http
export MCP_HTTP_ADDR=:8080
./1c-mcp-server

Эндпоинты:

• / — MCP (при включённой авторизации — заголовок Authorization: Bearer <token>).
• GET /version — версия сборки (без авторизации).
• GET /metrics — метрики Prometheus (без авторизации).
• /admin/* — административные операции только при заданном MCP_ADMIN_TOKEN.

Безопасность в HTTP

Если MCP_AUTH_TOKENS не задан, сервер не требует Bearer-токен для MCP: так нельзя выставлять в открытый интернет без reverse proxy и сетевых ограничений.

Рекомендуется:

• задать один или несколько токенов: MCP_AUTH_TOKENS (через запятую) или флаг -auth-tokens;
• для админки — отдельный MCP_ADMIN_TOKEN;
• при необходимости ограничить доступ на уровне файрвола или VPN.

Пример:

export MCP_AUTH_TOKENS="your-long-random-secret"
export MCP_ADMIN_TOKEN="another-long-secret"

Файл конфигурации

Опционально: --config path/to/mcp.yaml (или mcp.json). В конфиге можно задать транспорт, адрес HTTP, токены, каталог логов сессий, таймауты и параметры LRU-кеша для resolve/getmeta. Поля см. в internal/config/config.go.

Локальные файлы с секретами удобно де

... View full README on GitHub