# HelpSearchServer

Поиск по справке платформы 1С конкретной версии с использованием RAG (Retrieval-Augmented Generation).

## Назначение

HelpSearchServer — это **самый важный** MCP-сервер для разработки на 1С. Он предоставляет ИИ доступ к официальной справке платформы 1С именно вашей версии.

### Почему это важно?

* Методы и параметры меняются от версии к версии
* ИИ без справки может давать устаревшую информацию
* Поиск по смыслу, а не только по названию метода

## Доступные инструменты MCP

ИИ получает следующие инструменты:

| Инструмент  | Описание                                                                |
| ----------- | ----------------------------------------------------------------------- |
| `docsearch` | Поиск по справке платформы 1С по описанию, вопросу или частичному имени |
| `docinfo`   | Получение документации по точному имени объекта, метода или свойства    |

### docsearch

Поиск по документации синтаксиса 1С с гибридным подходом (векторный + полнотекстовый). Используйте для поиска по описанию, вопросу или частичному имени. Если известно точное имя объекта или метода — используйте `docinfo`.

| Параметр | Тип    | Описание                                                                                  |
| -------- | ------ | ----------------------------------------------------------------------------------------- |
| `query`  | string | Поисковый запрос — описание нужной функциональности или ключевые слова (на русском языке) |

**Возврат**: Отформатированная строка с результатами поиска, разделёнными `---`.

**Логика поиска** зависит от длины запроса:

* 1 слово — сначала полнотекстовый, затем векторный поиск
* 2–3 слова — сначала векторный, затем полнотекстовый поиск
* 4+ слов — только векторный поиск

***

### docinfo

Получает документацию по точному имени объекта, метода или свойства платформы 1С. Используйте, когда знаете конкретное имя. Для методов и свойств объекта указывайте имя в формате `ИмяОбъекта.ИмяМетода`.

| Параметр | Тип    | Описание                                                                                      |
| -------- | ------ | --------------------------------------------------------------------------------------------- |
| `name`   | string | Точное имя объекта, метода или свойства 1С. Для членов объекта — формат `ИмяОбъекта.ИмяЧлена` |

**Возврат**: Содержимое документации в формате Markdown или сообщение об отсутствии результатов.

**Примеры значений параметра `name`:**

* `ТаблицаЗначений` — объект
* `Массив.Найти` — метод объекта
* `Запрос` — объект
* `HTTPЗапрос` — объект

**Логика поиска:**

1. Точное совпадение по полному имени (`ИмяОбъекта.ИмяМетода`)
2. Если не найдено — поиск по имени (`ИмяМетода`)
3. Если имя содержит точку — раздельный поиск по объекту и члену

{% hint style="info" %}
Если `docinfo` не нашёл результат, попробуйте `docsearch` с описанием нужной функциональности.
{% endhint %}

## Возможности

ИИ получает инструменты для:

* Получения документации по точному имени объекта или метода
* Поиска методов и их параметров по описанию
* Поиска по описанию функциональности
* Получения примеров использования
* Уточнения синтаксиса конструкций

## Примеры запросов

После подключения сервера ИИ может отвечать на вопросы:

* "Как сгенерировать случайное число?"
* "Как работать с временными таблицами в запросах?"
* "Как получить текущую дату сеанса?"
* "Какие есть методы для работы с файлами?"

А при точном знании имени — получать документацию напрямую:

* "Покажи документацию по ТаблицаЗначений"
* "Что принимает метод Массив.Найти?"

## Требования

* Docker Desktop с WSL2
* Папка `bin` установленной платформы 1С
* Лицензионный ключ
* Embedding модель (LM Studio или CPU)

## Порт

**8003**

## Образ Docker

```
comol/1c_help_mcp:latest
```

## Быстрый старт

```powershell
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
```

Подробнее: [Установка](/mcp-servery-1c/servery/help-search-server/ustanovka.md)

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

```json
{
  "mcpServers": {
    "1c-docs-mcp": {
      "url": "http://localhost:8003/mcp",
      "connection_id": "1c_docs_service_001"
    }
  }
}
```

## Структура раздела

* [Установка](/mcp-servery-1c/servery/help-search-server/ustanovka.md) — команды запуска
* [Конфигурация](/mcp-servery-1c/servery/help-search-server/konfiguraciya.md) — все параметры
* [Использование](/mcp-servery-1c/servery/help-search-server/ispolzovanie.md) — примеры работы


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onerpa.ru/mcp-servery-1c/servery/help-search-server.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.