MCP серверы

Обзор всех доступных MCP-серверов для разработки на 1С.

Список серверов

Сервер	Порт	Назначение	Сложность	Плагины
HelpSearchServer	8003	Справка платформы 1С, руководства, спецификации форматов, стандарты	Средняя	Да
CodeMetadataSearchServer	8000	Метаданные и код конфигурации	Средняя	Да
Graph Metadata Search	8006	Графовый поиск связей	Высокая	Да (GRAPH_PLUGINS_ENABLED)
SSLSearchServer	8008	Библиотека стандартных подсистем	Низкая	Да
SyntaxCheckServer	8002	Проверка синтаксиса BSL	Низкая	Да
TemplatesSearchServer	8004	Шаблоны кода 1С и проектная память	Низкая	Да
1CCodeChecker	8007	Проверка через 1С:Напарник	Низкая	Да
MCP QA	8020	Автотестирование управляемых форм 1С	Средняя	Нет
Конвертация данных 2.0 (KD20)	8009	Правила обмена «Конвертации данных» 2.0	Средняя	Нет

Колонка «Плагины» — поддерживает ли сервер доработку одним Python-файлом без пересборки образа. Общие правила, справочник хуков по серверам и рецепты: Доработка MCP: система плагинов.

Актуальные версии серверов по умолчанию используют транспорт streamable-http на endpoint /mcp. Для старых клиентов можно включить SSE через USESSE=true; у Graph Metadata Search переменная называется MCP_USE_SSE. URL при этом остаётся /mcp, если в документации конкретного сервера не указано иное.

Классификация по сложности

Простые (не требуют данных)

Можно запустить сразу после установки Docker:

1. SyntaxCheckServer — проверка синтаксиса строки BSL; при подключении каталога FILES_DIR также проверяет файлы

2. TemplatesSearchServer — шаблоны кода

3. SSLSearchServer — справка БСП

4. HelpSearchServer — корпуса справки, спецификаций и стандартов поставляются в образе; папка bin нужна только для своей версии платформы

Требующие данных

Нужна подготовка данных из конфигурации:

1. CodeMetadataSearchServer — нужна выгрузка конфигурации

2. Graph Metadata Search — нужна выгрузка + Neo4j

3. Конвертация данных 2.0 (KD20) — нужны выгрузки источника и приёмника обмена

Требующие внешних ресурсов

1. 1CCodeChecker — нужен токен 1С:Напарник

Приоритет установки

Этап 1: Быстрый старт

# SyntaxCheckServer
docker run -d -p 8002:8002 --name 1c_syntaxcheck_mcp `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  comol/1c_syntaxcheck_mcp:latest

Этап 2: Если используете БСП

# SSLSearchServer
docker run -d -p 8008:8008 --name mcp_ssl_server `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e SSL_VERSION=3.1.11 `
  -v "E:/bases/mcp_ssl:/app/zvec_db" `
  comol/mcp_ssl_server:latest

Этап 3: Справка платформы

# HelpSearchServer
docker run -d -p 8003:8003 --name 1c_help_mcp `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -v "E:/bases/mcp_docs:/app/index" `
  comol/1c_help_mcp:latest

Справка платформы поставляется внутри образа. Чтобы индексировать справку своей версии, добавьте -v "C:/Program Files/1cv8/8.3.23.1997/bin:/1c_docs" и -e 1C_BIN_PATH=/1c_docs.

Этап 4: Метаданные конфигурации

Требует выгрузки из Конфигуратора. См. CodeMetadataSearchServer.

Общие переменные окружения

Часто встречающиеся переменные. Поддержка зависит от сервера; точный список приведён на его странице:

Переменная	Описание	Обязательная
LICENSE_KEY	Лицензионный ключ	Да
RESET_DATABASE	Переиндексировать данные	Нет (default: false)
RESET_CACHE	Очистить кэш моделей	Нет (default: false)
USESSE	SSE транспорт	Нет (default: false)

Embedding модели

Переменная	Описание
EMBEDDING_API_BASE	URL API (LM Studio: http://host.docker.internal:1234/v1)
EMBEDDING_API_KEY	Ключ API (любой для LM Studio)
EMBEDDING_MODEL	Модель API или встроенная CPU-модель

Старые имена OPENAI_API_BASE, OPENAI_API_KEY и OPENAI_MODEL остаются совместимыми алиасами.

Мониторинг контейнеров

Просмотр запущенных контейнеров

docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

Просмотр логов

# Все логи
docker logs 1c_help_mcp

# В реальном времени
docker logs -f 1c_help_mcp

# Последние 100 строк
docker logs --tail 100 1c_help_mcp

Перезапуск контейнера

docker restart 1c_help_mcp

Остановка и удаление

docker stop 1c_help_mcp
docker rm 1c_help_mcp

Общие рекомендации

Хранение данных

Всегда монтируйте внешние тома для:

• Векторных БД (/app/chroma_db, /app/data или путь, указанный в странице конкретного сервера)

• Кэша моделей (/app/model_cache)

Первый запуск

При первом запуске происходит индексация данных:

• Может занять от минут до часов

• Следите за логами: docker logs -f <container>

• Используйте RESET_DATABASE=false для последующих запусков

Embedding модели

Для лучшего качества используйте LM Studio или Ollama с Qwen моделями. Подробнее: Embedding модели.