# embedded-docs

Отдаёт агенту дословные фрагменты документации с указанием раздела и страницы. Пригодится, когда нужно точное значение регистра, а не догадка.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 26
- Автор: ByteAsk
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ByteAsk/ByteAsk-Embedded-MCP
- Обновлён: 2026-06-20
- HTML: https://affpapa.org/nevibecode/mcp/embedded-docs

## Что делает

Сервер принимает запрос на естественном языке или точный идентификатор и возвращает ранжированные фрагменты исходных документов: заголовок документа, ссылку на раздел и страницу, сам текст и `result_id`. Если ничего достаточно близкого нет, ответ будет «no confident match» — выдумывать значение регистра сервер не станет. Инструмент `get_context` разворачивает найденный фрагмент до полного раздела, а `request_document` отправляет запрос на добавление недостающего документа.

Внутри — три инструмента и два транспорта: `stdio` для локальных агентов и Streamable HTTP для хостинга. Поисковый движок и корпус документов в репозиторий не входят, они стоят за интерфейсом `SearchBackend` из двух методов и работают на хостинге `https://mcp.byteask.ai/mcp`. Локально поднимается встроенный `SampleBackend` с несколькими показательными записями, так что `search_docs` отвечает сразу и без ключей API. Свой поиск подключается через переменную `BYTEASK_BACKEND` в формате `module:callable`.

Для локального запуска нужен Python 3.10 или новее и `uv`. Настройки читаются из переменных окружения и `.env`: транспорт, адрес и порт HTTP, bearer-токен, список разрешённых хостов в заголовке `Host`. Пустой `MCP_HTTP_AUTH_TOKEN` оставляет HTTP-сервер без аутентификации — это годится только для локальной разработки, наружу такой сервер выставлять нельзя.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://mcp.byteask.ai/mcp`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http embedded-docs https://mcp.byteask.ai/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add embedded-docs --url https://mcp.byteask.ai/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "embedded-docs": {
            "url": "https://mcp.byteask.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "embedded-docs": {
            "type": "http",
            "url": "https://mcp.byteask.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http embedded-docs https://mcp.byteask.ai/mcp
```

## Когда брать
- уточнить смещение регистра перед правкой драйвера
- найти номер функции Modbus для записи нескольких регистров
- свериться с пунктом стандарта вместо ответа по памяти
- подтянуть точный синтаксис SCPI-команды
- запросить добавление недостающего даташита в корпус

## Примеры запросов агенту
- Найди в документации, какой код функции Modbus пишет несколько регистров подряд
- Проверь по даташиту смещение регистра ETH_DMATDLAR и покажи страницу
- Раскрой полный раздел по найденному фрагменту `result_id`

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md