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

Переменные окружения MCP сервера

Обязательные

Переменная	Описание	Пример
LICENSE_KEY	Лицензионный ключ	YOUR_LICENSE_KEY
NEO4J_URI	URI подключения к Neo4j	bolt://neo4j:7687
NEO4J_USERNAME	Пользователь Neo4j	neo4j
NEO4J_PASSWORD	Пароль Neo4j	password123
METADATA_DIRECTORY	Путь к метаданным (отчёт из конфигуратора)	/app/metadata

Управление индексацией

Переменная	Описание	По умолчанию
RESET_DATABASE	Переиндексировать при запуске	true
AUTO_UPDATE_ON_STARTUP	Авто-обновление индексов при запуске	true
ASYNC_VECTOR_INDEXING	Индексация векторов в фоне (неблокирующая)	true
INDEX_BATCH_SIZE	Количество объектов, обрабатываемых за один пакет при создании векторного индекса	50
MAX_TOKENS_PER_BATCH	Максимальное количество токенов в одном пакете запроса к API эмбеддингов	7500
EMBEDDING_MAX_TOKENS	Максимальное количество токенов на один текст при генерации эмбеддингов. Определяется автоматически по модели, но можно переопределить	(авто)

Embedding модели

Переменная	Описание	Пример
OPENAI_API_BASE	URL API для генерации и LLM	http://host.docker.internal:1234/v1
OPENAI_API_KEY	Ключ API для генерации и LLM	lm-studio
OPENAI_MODEL	LLM модель для генерации описаний	gpt-5
OPENAI_TEMPERATURE	Температура генерации (0–1). Для reasoning-моделей (o1, o3, gpt-5) игнорируется	0.1
OPENAI_MAX_COMPLETION_TOKENS	Максимальное количество токенов в ответе LLM	2000
OPENAI_MODEL_IS_REASONING	Принудительное указание, является ли модель «рассуждающей». Если не указано — определяется автоматически по имени модели (o1*, o3*, gpt-5*)	(авто)
OPENAI_EMBEDDING_API_BASE	Отдельный URL для API эмбеддингов (если отличается от основного)	—
OPENAI_EMBEDDING_API_KEY	Отдельный ключ для API эмбеддингов	—
OPENAI_EMBEDDING_MODEL	Модель для эмбеддингов	Qwen3-Embedding-4B
OPENAI_EMBEDDING_DIMENSIONS	Явное указание размерности эмбеддингов	(авто)
EMBEDDING_MODEL	Локальная CPU модель (sentence-transformers)	intfloat/multilingual-e5-small
EMBEDDING_ALLOW_OFFLINE_FALLBACK	Разрешить автопереход на локальную модель при недоступности API	true

Шаблонный режим

Переменная	Описание	По умолчанию
TEMPLATE_MODE_ENABLED	Включить шаблонный режим — JSON-запросы с мгновенными ответами без LLM	true
TEMPLATE_MODE_ONLY	Только шаблонные запросы, LLM не используется. Требует TEMPLATE_MODE_ENABLED=true	false

Поиск по коду

Переменная	Описание	По умолчанию
ENABLE_CODE_SEARCH	Включить поиск по BSL-файлам	true
CODE_SEARCH_MAX_FILE_SIZE	Максимальный размер BSL-файла (байт) для индексации	50000

Семантический поиск

Переменная	Описание	По умолчанию
ENABLE_BUSINESS_SEARCH	Включить семантический поиск по бизнес-описаниям	true
CALCULATE_BUSINESS_INFO	Генерировать AI бизнес-описания для объектов метаданных	false
BUSINESS_INFO_MAX_TOKENS	Максимум токенов контекста для бизнес-описаний	4000
BUSINESS_INFO_RETRY_COUNT	Количество повторных попыток при ошибках API	3
ENABLE_METADATA_DESCRIPTION_EMBEDDING	Генерировать эмбеддинги для описательных полей метаданных (Синоним, Комментарий, Описание, справка)	false

BSL-граф (Module / Routine / CALLS)

Переменная	Описание	По умолчанию
CODE_EXPORT_PATH	Путь к XML-выгрузке конфигурации в файлы (Конфигуратор → Выгрузить конфигурацию в файлы)	—
LOAD_BSL_SIGNATURES	Загружать сигнатуры BSL-кода в граф — создавать ноды Module и Routine с графом вызовов CALLS	false
ENABLE_ROUTINE_EMBEDDINGS	Генерировать эмбеддинги для процедур/функций. Требует LOAD_BSL_SIGNATURES=true. Индексация в фоновом потоке	true

Дополнительные данные из XML-выгрузки

Все опции ниже требуют заполнения CODE_EXPORT_PATH.

Переменная	Описание	По умолчанию
LOAD_FORMS_FROM_XML	Загружать структуру управляемых форм из Ext/Form.xml (FormControl, FormEvent, FormAttribute)	false
LOAD_EVENT_SUBSCRIPTIONS	Загружать подписки на события из EventSubscriptions/*.xml	false
LOAD_PREDEFINED_VALUES	Загружать предопределённые элементы из */Predefined.xml	false
LOAD_ROLE_RIGHTS	Загружать права ролей из Roles/*/Ext/Rights.xml	false
LOAD_HELP_FROM_HTML	Загружать справку объектов из */Help/ru.html	false

Поддержка расширений

Переменная	Описание	По умолчанию
EXTENSION_NAME	Имя расширения. Если задано, все загружаемые объекты получают origin="extension"	—
EXTENSION_BASE_PROJECT	Имя базового проекта (PROJECT_NAME базовой конфигурации) для построения связей EXTENDS/OVERRIDES	—

Дополнительные

Переменная	Описание	По умолчанию
MCP_HOST	Хост MCP-сервера	0.0.0.0
MCP_PORT	Порт MCP	8006
MCP_PATH	URL-путь для MCP эндпоинта	/mcp
MCP_USE_SSE	SSE транспорт (для legacy клиентов)	false
PROJECT_NAME	Название проекта (для логов, интерфейса и мультипроектности)	1C Metadata Project
DEBUG	Режим отладки — дополнительные логи	false

Переменные Neo4j

Переменная	Описание	Пример
NEO4J_AUTH	Логин/пароль	neo4j/password123
NEO4J_server_memory_heap_max__size	Макс. память	1g

Монтируемые тома

MCP сервер

Хост	Контейнер	Назначение
E:/1C_Export/Report	/app/metadata	Отчёт по метаданным
E:/1C_Export/Files	/app/metadata_files	Файлы кода (BSL, XML, справка)

Neo4j

Хост	Контейнер	Назначение
E:/bases/mcp_graph/neo4j	/data	Данные Neo4j

Полный docker-compose.yml

version: '3.8'

services:
  neo4j:
    image: neo4j:latest
    container_name: neo4j
    restart: unless-stopped
    ports:
      - "7474:7474"
      - "7687:7687"
    environment:
      - NEO4J_AUTH=neo4j/password123
      - NEO4J_server_memory_heap_initial__size=512m
      - NEO4J_server_memory_heap_max__size=1g
      - NEO4J_server_memory_pagecache_size=512m
    volumes:
      - E:/bases/mcp_graph/neo4j:/data
    deploy:
      resources:
        limits:
          memory: 2G
    healthcheck:
      test: ["CMD-SHELL", "wget --spider localhost:7474 || exit 1"]
      interval: 30s
      timeout: 10s
      retries: 5

  mcp-app:
    image: comol/1c_graph_metadata:latest
    container_name: 1c_graph_metadata
    restart: unless-stopped
    ports:
      - "8006:8006"
    environment:
      # === Обязательные ===
      - LICENSE_KEY=YOUR_LICENSE_KEY
      - NEO4J_URI=bolt://neo4j:7687
      - NEO4J_USERNAME=neo4j
      - NEO4J_PASSWORD=password123
      - METADATA_DIRECTORY=/app/metadata
      - RESET_DATABASE=false
      # === Embedding / LLM ===
      - OPENAI_API_BASE=http://host.docker.internal:1234/v1
      - OPENAI_API_KEY=lm-studio
      - OPENAI_MODEL=gpt-5
      - OPENAI_EMBEDDING_MODEL=Qwen3-Embedding-4B
      # === Шаблонный режим ===
      - TEMPLATE_MODE_ENABLED=true
      # === BSL-граф ===
      - CODE_EXPORT_PATH=/app/metadata_files
      - LOAD_BSL_SIGNATURES=true
      - ENABLE_ROUTINE_EMBEDDINGS=true
      # === XML-данные (опционально) ===
      # - LOAD_FORMS_FROM_XML=true
      # - LOAD_EVENT_SUBSCRIPTIONS=true
      # - LOAD_PREDEFINED_VALUES=true
      # - LOAD_ROLE_RIGHTS=true
      # - LOAD_HELP_FROM_HTML=true
      # === Поиск ===
      - ENABLE_BUSINESS_SEARCH=true
      # - ENABLE_METADATA_DESCRIPTION_EMBEDDING=true
      # === Проект ===
      - MCP_PORT=8006
      - PROJECT_NAME=МояКонфигурация
    volumes:
      - E:/1C_Export/Report:/app/metadata
      - E:/1C_Export/Files:/app/metadata_files
    deploy:
      resources:
        limits:
          memory: 1G
    depends_on:
      neo4j:
        condition: service_healthy

Пример: загрузка расширения

Для загрузки расширения запустите отдельный экземпляр сервера с указанием EXTENSION_NAME и EXTENSION_BASE_PROJECT:

  mcp-extension:
    image: comol/1c_graph_metadata:latest
    container_name: 1c_graph_metadata_ext
    environment:
      - LICENSE_KEY=YOUR_LICENSE_KEY
      - NEO4J_URI=bolt://neo4j:7687
      - NEO4J_USERNAME=neo4j
      - NEO4J_PASSWORD=password123
      - METADATA_DIRECTORY=/app/metadata
      - RESET_DATABASE=true
      - EXTENSION_NAME=МоёРасширение
      - EXTENSION_BASE_PROJECT=МояКонфигурация
      - OPENAI_API_BASE=http://host.docker.internal:1234/v1
      - OPENAI_API_KEY=lm-studio
      - OPENAI_EMBEDDING_MODEL=Qwen3-Embedding-4B
      - CODE_EXPORT_PATH=/app/metadata_files
      - LOAD_BSL_SIGNATURES=true
    volumes:
      - E:/1C_Export_Extension/Report:/app/metadata
      - E:/1C_Export_Extension/Files:/app/metadata_files
    depends_on:
      neo4j:
        condition: service_healthy

После загрузки расширения через основной MCP-сервер станут доступны инструменты compare_base_and_extension и шаблонные операции для работы с расширениями.

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

{
  "mcpServers": {
    "1c-graph-metadata-mcp": {
      "url": "http://localhost:8006/mcp",
      "connection_id": "1c_graph_service_001"
    }
  }
}