> 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/prilozhenia/glossarij.md). # Глоссарий Термины, используемые в документации MCP-серверов. ## Основные термины ### MCP (Model Context Protocol) Протокол для расширения возможностей LLM через внешние инструменты. Позволяет ИИ получать данные из специализированных серверов. ### RAG (Retrieval-Augmented Generation) Технология, при которой ИИ сначала ищет релевантную информацию в базе данных, а затем использует её для генерации ответа. Повышает точность и актуальность ответов. ### Embedding Векторное представление текста. Текст преобразуется в массив чисел, что позволяет измерять "похожесть" текстов по расстоянию между векторами. ### Embedding модель Нейронная сеть, которая преобразует текст в embedding. Качество модели влияет на качество поиска. Примеры: * `Qwen3-Embedding-4B` — высокое качество, GPU * `multilingual-e5-small` — быстрая, CPU ### zvec Встроенная векторная база данных, используемая серверами. Хранит embeddings и позволяет быстро искать похожие по смыслу документы; работает внутри процесса сервера, отдельной службы не требует. ### ChromaDB Векторная база данных, которая использовалась в прежних версиях серверов. Заменена на zvec; имя `chroma_db` кое-где сохранилось как путь тома для совместимости с существующими установками. ### Поколение индекса (generation) Неизменяемый снимок индекса. Пересборка пишет новое поколение рядом с обслуживающим и переводит обслуживание на него только после проверки — поэтому поиск отвечает всё время пересборки, а неудавшаяся сборка ничего не портит. ### Neo4j Графовая база данных. Хранит данные в виде узлов и связей. Используется в Graph Metadata Search. ## Термины системы плагинов ### Плагин Один Python-файл в каталоге плагинов сервера, объявляющий функции известных имён. Не требует базового класса, декоратора, регистрации, манифеста и сборки; пустой файл — валидный плагин. См. [Систему плагинов](/mcp-servery-1c/sistema-pluginov.md). ### Hook (хук) Функция плагина с именем из объявленного сервером набора, которую сервер вызывает в определённой точке своей работы. Хук получает копию payload, и применяется только возвращённое значение. ### Контракт хоста Общая для всех серверов семейства половина системы плагинов: загрузка файлов, передача аргументов, семантика возврата, изоляция сбоев, порядок, перезагрузка, эпохи, интроспекция, версии, dry-run. Версионируется константой `HOST_CONTRACT_VERSION`. ### Набор хуков (hook set) Продуктовая половина: какие хуки и таблицы предлагает конкретный сервер и какой у них payload. Версионируется константой `HOOKS_VERSION`, продукт — константой `PRODUCT`. ### Call-scoped хук Хук, влияющий на один вызов и ни на что, что его переживает. Правка действует со следующего вызова после перезагрузки каталога и ничего не пересобирает. ### Derived-state хук Хук, формирующий состояние, которое сервер строит один раз и переиспользует: индекс, векторную коллекцию, граф. Исходник такого файла входит в отпечаток годности состояния, поэтому его правка вызывает пересборку. ### Декларативная таблица Модульная константа плагина, которую сервер читает как данные (`ALIASES`, `QUERY_ALIASES`, `TOOL_PRESETS`, `CYPHER_TEMPLATES`, `SUPPRESSED_DIAGNOSTICS`). На затронутом ею пути код плагина не выполняется, поэтому таблица не может упасть. ### Эпоха плагинов (plugin epoch) Номер действующего набора плагинов. Перезагрузка каталога начинает новую эпоху; курсоры продолжения, выданные в предыдущей, отклоняются как устаревшие. ### Dry-run Команда образа, прогоняющая хуки одного файла на зашитых в образ фикстурах и печатающая payload до и после — без смонтированных данных, построенного индекса и запущенного сервера. ## Термины 1С ### БСП (Библиотека стандартных подсистем) Набор готовых подсистем для конфигураций 1С: пользователи, отчёты, печать и т.д. ### BSL (Built-in Scripting Language) Встроенный язык программирования платформы 1С. ### Конфигурация Прикладное решение на платформе 1С:Предприятие. ### Метаданные Описание структуры конфигурации: справочники, документы, регистры, реквизиты и т.д. ### Конфигуратор Среда разработки 1С для создания и редактирования конфигураций. ### EDT (Enterprise Development Tools) Современная IDE для разработки на 1С на базе Eclipse. ## Термины Docker ### Контейнер Изолированное окружение для запуска приложения. Содержит код, библиотеки и настройки. ### Образ (Image) Шаблон для создания контейнера. Хранится в Docker Hub или локально. ### Docker Hub Публичный репозиторий Docker-образов. MCP-серверы доступны как `comol/*`. ### Том (Volume) Механизм хранения данных контейнера на хосте. Данные сохраняются при перезапуске контейнера. ### WSL2 (Windows Subsystem for Linux 2) Подсистема Windows для запуска Linux. Требуется для Docker Desktop на Windows. ### docker-compose Инструмент для запуска нескольких контейнеров как единого приложения. ## Термины Cursor ### Cursor IDE на базе VS Code с встроенной поддержкой ИИ и протокола MCP. ### mcp.json Файл конфигурации MCP-серверов для Cursor. ### Cursor Rules Правила, определяющие поведение ИИ в Cursor для конкретного проекта. ## Термины сети ### Порт Номер для идентификации приложения в сети. MCP-серверы используют порты 8000-8008. ### localhost Адрес локального компьютера (127.0.0.1). ### host.docker.internal Специальный адрес для доступа из контейнера Docker к хост-машине в Windows/Mac. ### SSE (Server-Sent Events) Технология для отправки данных от сервера к клиенту. Используется некоторыми MCP-клиентами. ## Термины LM Studio ### LM Studio Приложение для локального запуска LLM и embedding моделей. ### GGUF Формат файлов моделей, оптимизированный для локального запуска. ### Квантизация Уменьшение точности весов модели для снижения требований к памяти. Q8 > Q6 > Q4 по качеству. ### VRAM Видеопамять GPU. Требуется для запуска моделей на видеокарте. ## Термины Ollama ### Ollama Инструмент для локального запуска LLM через командную строку. ### Ollama API OpenAI-совместимый API на порту 11434. ## Сокращения | Сокращение | Расшифровка | | ---------- | --------------------------------- | | API | Application Programming Interface | | CLI | Command Line Interface | | CPU | Central Processing Unit | | GPU | Graphics Processing Unit | | GUI | Graphical User Interface | | HTTP | Hypertext Transfer Protocol | | JSON | JavaScript Object Notation | | LLM | Large Language Model | | RAM | Random Access Memory | | SSD | Solid State Drive | | URL | Uniform Resource Locator | | XML | Extensible Markup Language |