embedded-docs — MCP-сервер для Claude Code: цитаты из даташитов
Отдаёт агенту дословные фрагменты документации с указанием раздела и страницы. Пригодится, когда нужно точное значение регистра, а не догадка.
claude mcp add --transport http embedded-docs https://mcp.byteask.ai/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-сервер без аутентификации — это годится только для локальной разработки, наружу такой сервер выставлять нельзя.
Какие задачи решает
- уточнить смещение регистра перед правкой драйвера
- найти номер функции Modbus для записи нескольких регистров
- свериться с пунктом стандарта вместо ответа по памяти
- подтянуть точный синтаксис SCPI-команды
- запросить добавление недостающего даташита в корпус
Примеры запросов агенту
- Найди в документации, какой код функции Modbus пишет несколько регистров подряд
- Проверь по даташиту смещение регистра ETH_DMATDLAR и покажи страницу
- Раскрой полный раздел по найденному фрагменту
result_id
Как установить embedded-docs
Командой платформы: удалённый сервер
claude mcp add --transport http embedded-docs https://mcp.byteask.ai/mcpКомандой платформы: удалённый сервер
codex mcp add embedded-docs --url https://mcp.byteask.ai/mcpФайл настроек
{
"mcpServers": {
"embedded-docs": {
"url": "https://mcp.byteask.ai/mcp"
}
}
}Файл настроек
{
"servers": {
"embedded-docs": {
"type": "http",
"url": "https://mcp.byteask.ai/mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http embedded-docs https://mcp.byteask.ai/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о embedded-docs
Как установить embedded-docs в Claude Code?
Одной командой: claude mcp add --transport http embedded-docs https://mcp.byteask.ai/mcp. Она подключает хостинговый сервер по Streamable HTTP, локально ничего ставить не нужно.
Что делает embedded-docs?
Ищет по корпусу встроенной документации и возвращает дословные фрагменты с указанием раздела и страницы. Когда совпадений нет, честно сообщает об этом вместо придуманного ответа.
Можно ли подключить свой поисковый движок?
Да. Реализуйте интерфейс SearchBackend с методами search и get_context, добавьте фабрику make_backend(config) и укажите её в BYTEASK_BACKEND как module:callable.
