Установка

Предварительные требования

1. Docker Desktop запущен

2. LM Studio запущен с моделью Qwen3-Embedding (рекомендуется)

3. Установлена платформа 1С:Предприятие

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

Поиск папки bin

Справка платформы находится в папке bin установленной версии 1С.

Типичные пути:

• C:\Program Files\1cv8\8.3.23.1997\bin

• C:\Program Files (x86)\1cv8\8.3.23.1997\bin

Создание папки для индекса

New-Item -ItemType Directory -Force -Path "E:\bases\mcp_docs"

Путь E:\bases\mcp_docs — это пример. Используйте любой удобный путь на вашем компьютере.

КРИТИЧЕСКИ ВАЖНО! Обязательно монтируйте папку для векторной БД (-v "...:/app/chroma_db"). Без этого при каждом перезапуске контейнера индексация будет начинаться заново, что может занять от нескольких часов до суток!

Команды запуска

С LM Studio (рекомендуется)

docker run -d -p 8003:8003 `
  --name 1c_help_mcp `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e 1C_BIN_PATH=/1c_docs `
  -e RESET_CACHE=false `
  -e RESET_DATABASE=false `
  -e OPENAI_API_BASE=http://host.docker.internal:1234/v1 `
  -e OPENAI_API_KEY=lm-studio `
  -e OPENAI_MODEL=Qwen3-Embedding-4B `
  -v "C:/Program Files/1cv8/8.3.23.1997/bin:/1c_docs" `
  -v "E:/bases/mcp_docs:/app/chroma_db" `
  -v "E:/bases/mcp_model_cache:/app/model_cache" `
  comol/1c_help_mcp:latest

Если LM Studio запущен локально на порту 1234 (по умолчанию), параметры OPENAI_API_BASE и OPENAI_API_KEY можно не указывать — сервер подключится автоматически.

С CPU (без GPU)

docker run -d -p 8003:8003 `
  --name 1c_help_mcp `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e 1C_BIN_PATH=/1c_docs `
  -e RESET_CACHE=false `
  -e RESET_DATABASE=false `
  -v "C:/Program Files/1cv8/8.3.23.1997/bin:/1c_docs" `
  -v "E:/bases/mcp_docs:/app/chroma_db" `
  -v "E:/bases/mcp_model_cache:/app/model_cache" `
  comol/1c_help_mcp:latest

Замените 8.3.23.1997 на вашу версию платформы!

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

Процесс индексации

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

1. Скачивание образа (~2-3 ГБ)

2. Загрузка embedding модели (если CPU режим)

3. Индексация справки (см. таблицу ниже)

Ожидаемое время индексации

Режим	Время индексации
CPU (e5-small)	10-20 часов
CPU (e5-base)	15-30 часов
GPU (Qwen-4B через LM Studio)	2-4 часа

Планируйте первую индексацию заранее — запустите контейнер на ночь или на выходных. После завершения индекс сохранится в томе и повторная индексация не потребуется.

Мониторинг прогресса

# Просмотр логов в реальном времени
docker logs -f 1c_help_mcp

Пример вывода:

Starting HelpSearchServer...
Loading embedding model...
Indexing documentation from /1c_docs...
Indexed 1000/5432 documents...
Indexed 2000/5432 documents...
...
Indexing complete! Starting MCP server on port 8003

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

# Проверить статус контейнера
docker ps --filter name=1c_help_mcp

# Проверить доступность
curl http://localhost:8003/health

Последующие запуски

После первой индексации используйте RESET_DATABASE=false:

# Остановка
docker stop 1c_help_mcp

# Запуск (индекс сохранён)
docker start 1c_help_mcp

Обновление справки

При обновлении версии платформы 1С:

1. Остановите контейнер

2. Измените путь к новой версии

3. Установите RESET_DATABASE=true

4. Запустите контейнер

docker stop 1c_help_mcp
docker rm 1c_help_mcp

docker run -d -p 8003:8003 `
  --name 1c_help_mcp `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e RESET_DATABASE=true `
  -v "C:/Program Files/1cv8/8.3.24.1234/bin:/1c_docs" `
  -v "E:/bases/mcp_docs:/app/chroma_db" `
  comol/1c_help_mcp:latest

Проверка работы

Тест MCP endpoint

# Простая проверка доступности
Invoke-RestMethod -Uri "http://localhost:8003/health"

Настройка Cursor

1. Откройте %APPDATA%\Cursor\User\globalStorage\mcp.json

2. Добавьте конфигурацию сервера

3. Перезапустите Cursor

4. Задайте вопрос о методах 1С

Устранение проблем

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

# Проверить логи
docker logs 1c_help_mcp

Ошибка "path not found"

Проверьте путь к папке bin:

Test-Path "C:\Program Files\1cv8\8.3.23.1997\bin"

Ошибка подключения к LM Studio

1. Убедитесь, что LM Studio Server запущен

2. Проверьте порт 1234

3. Используйте host.docker.internal вместо localhost