MCP серверы

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

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

Сервер	Порт	Назначение	Сложность
HelpSearchServer	8003	Справка платформы 1С	Средняя
CodeMetadataSearchServer	8000	Метаданные и код конфигурации	Средняя
Graph Metadata Search	8006	Графовый поиск связей	Высокая
SSLSearchServer	8008	Библиотека стандартных подсистем	Низкая
SyntaxCheckServer	8002	Проверка синтаксиса BSL	Низкая
TemplatesSearchServer	8004	Шаблоны кода 1С и проектная память	Низкая
1CCodeChecker	8007	Проверка через 1С:Напарник	Низкая

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

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

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

1. SyntaxCheckServer — проверка синтаксиса

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

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

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

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

1. HelpSearchServer — нужна папка bin платформы 1С

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

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

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

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/chroma_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 "C:/Program Files/1cv8/8.3.23.1997/bin:/1c_docs" `
  -v "E:/bases/mcp_docs:/app/chroma_db" `
  comol/1c_help_mcp:latest

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

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

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

Переменные, которые используются во всех серверах:

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

Embedding модели

Переменная	Описание
OPENAI_API_BASE	URL API (LM Studio: http://host.docker.internal:1234/v1)
OPENAI_API_KEY	Ключ API (любой для LM Studio)
OPENAI_MODEL	Название модели
EMBEDDING_MODEL	Встроенная CPU модель

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

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

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/model_cache)

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

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

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

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

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

Embedding модели

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