> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/mcp-servery-1c/servery/code-metadata-search/ustanovka.md).

# Установка

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

1. Docker Engine или Docker Desktop запущен
2. LM Studio запущен (рекомендуется)
3. [Подготовлены данные](https://docs.onerpa.ru/mcp-servery-1c/servery/code-metadata-search/podgotovka-dannyh.md) из Конфигуратора

## Создание папок

```powershell
New-Item -ItemType Directory -Force -Path @(
    "E:\bases\mcp_codemetadata",
    "E:\1C_Export\Files"
)
```

## Выбор образа

| Тег      | Размер             | Описание                                                                                   |
| -------- | ------------------ | ------------------------------------------------------------------------------------------ |
| `latest` | \~2.9 GB           | Полная: локальные embedding (CPU/GPU) + API                                                |
| `light`  | \~290 MB           | Облегчённая: embedding только через API (LM Studio, OpenRouter и т.д.)                     |
| `arm64`  | \~1.45 GB (сжатый) | Для Apple Silicon / ARM серверов: локальные embedding на CPU (PyTorch CPU, без CUDA) + API |

{% hint style="info" %}
Если вы используете LM Studio или OpenRouter для embedding — выбирайте `light`. Образ в 10 раз легче и запускается быстрее.
{% endhint %}

{% hint style="warning" %}
Явно закрепляйте `EMBEDDING_MODEL` и, если модель поддерживает переменную размерность, `EMBEDDING_DIMENSIONS`. Их смена полностью переэмбеддирует пять векторных дорожек (`metadata`, `metadata_xml`, `code`, `help`, `form_index`) и повторно расходует время и лимиты провайдера. Подробности и текущая рекомендация — на странице [конфигурации](https://docs.onerpa.ru/mcp-servery-1c/servery/code-metadata-search/konfiguraciya.md).
{% endhint %}

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

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

```powershell
docker run -d -p 8000:8000 `
  --name 1c_code_metadata_mcp `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e CODE_PATH="/app/code" `
  -e METADATA_SOURCE=xml `
  -e SOURCE_FORMAT=auto `
  -e RESET_DATABASE=false `
  -e EMBEDDING_API_BASE=http://host.docker.internal:1234/v1 `
  -e EMBEDDING_API_KEY=lm-studio `
  -e EMBEDDING_MODEL=Qwen3-Embedding-4B `
  -v "E:/1C_Export/Files:/app/code" `
  -v "E:/bases/mcp_codemetadata:/app/chroma_db" `
  comol/1c_code_metadata_mcp:latest
```

### С LM Studio (облегчённый образ)

```powershell
docker run -d -p 8000:8000 `
  --name 1c_code_metadata_mcp `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e CODE_PATH="/app/code" `
  -e METADATA_SOURCE=xml `
  -e SOURCE_FORMAT=auto `
  -e RESET_DATABASE=false `
  -e EMBEDDING_API_BASE=http://host.docker.internal:1234/v1 `
  -e EMBEDDING_API_KEY=lm-studio `
  -e EMBEDDING_MODEL=Qwen3-Embedding-4B `
  -v "E:/1C_Export/Files:/app/code" `
  -v "E:/bases/mcp_codemetadata:/app/chroma_db" `
  comol/1c_code_metadata_mcp:light
```

### С CPU (без GPU)

```powershell
docker run -d -p 8000:8000 `
  --name 1c_code_metadata_mcp `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e CODE_PATH="/app/code" `
  -e METADATA_SOURCE=xml `
  -e SOURCE_FORMAT=auto `
  -e RESET_DATABASE=false `
  -e EMBEDDING_MODEL=intfloat/multilingual-e5-base `
  -v "E:/1C_Export/Files:/app/code" `
  -v "E:/bases/mcp_codemetadata:/app/chroma_db" `
  comol/1c_code_metadata_mcp:latest
```

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

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

1. Определение формата Designer XML / 1C:EDT и чтение метаданных
2. Анализ файлов кода, форм, справки и зависимостей
3. Создание векторного индекса

{% hint style="warning" %}
**Важно!** Монтируйте постоянный том для данных (`-v "...:/app/chroma_db"`): он сохраняет индекс при пересоздании контейнера. Том сам по себе не гарантирует возобновление незавершённой дорожки и не защищает от повреждения хранилища. Не удаляйте его после прерывания; см. [перезапуск и сохранность прогресса](https://docs.onerpa.ru/pages/UzUG2evPhPPS60qisAYA#%D0%BF%D0%B5%D1%80%D0%B5%D0%B7%D0%B0%D0%BF%D1%83%D1%81%D0%BA-%D0%B8-%D1%81%D0%BE%D1%85%D1%80%D0%B0%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D1%8C-%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B5%D1%81%D1%81%D0%B0).
{% endhint %}

### Мониторинг

```powershell
docker logs -f 1c_code_metadata_mcp
```

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

Первый запуск крупной конфигурации может занимать много часов. Подтверждённых сопоставимых замеров полного первого запуска типовых УТ/ERP на CPU, локальной GPU и через API пока нет; прежнюю таблицу часов по числу объектов нельзя использовать как норму.

На странице [«Время первичной индексации»](https://docs.onerpa.ru/mcp-servery-1c/servery/code-metadata-search/vremya-indeksacii.md) разобраны три режима, оценка остатка по реальному прогрессу и протокол сопоставимого замера. `ETA` в логе относится к текущей дорожке, не ко всему серверу. Ночное окно планируйте по замеру на своей выгрузке, а не по размеру Docker-образа.

Готовое корректное поколение сохраняется в томе и при неизменных исходниках и настройках не требует полной перестройки. Прерывание незавершённой дорожки, смена модели и повреждение хранилища — другие сценарии; наличие тома само по себе их не устраняет.

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

```powershell
docker ps --filter name=1c_code_metadata_mcp
```

## Конфигурация Cursor

```json
{
  "mcpServers": {
    "1c-code-metadata-mcp": {
      "url": "http://localhost:8000/mcp",
      "connection_id": "1c_metadata_service_001"
    }
  }
}
```

## Обновление после изменений конфигурации

```powershell
# Удалить старый контейнер
docker rm -f 1c_code_metadata_mcp

# Запустить с инкрементальным обновлением
docker run -d -p 8000:8000 `
  --name 1c_code_metadata_mcp `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e CODE_PATH="/app/code" `
  -e METADATA_SOURCE=xml `
  -e SOURCE_FORMAT=auto `
  -e RESET_DATABASE=false `
  -v "E:/1C_Export/Files:/app/code" `
  -v "E:/bases/mcp_codemetadata:/app/chroma_db" `
  comol/1c_code_metadata_mcp:latest
```

При `INCREMENTAL_INDEXING=true` сервер сравнивает SHA-256 исходников и атомарно публикует новое поколение после проверки. `RESET_DATABASE=true` используйте только для осознанной полной перестройки.
