hermes-docs-mcp
Provides offline full-text search and reading of Hermes Agent documentation, allowing agents to retrieve documentation fragments and full pages from a local cache.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@hermes-docs-mcp Search the docs for how to configure MCP servers in Hermes Agent"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
hermes-docs-mcp
Локальный MCP-сервер, который даёт агенту полнотекстовый поиск и чтение
документации Hermes Agent (hermes-agent.nousresearch.com/docs) — офлайн,
из локального кэша, без скрейпинга сайта.
Откуда берутся данные
Сайт документации сам публикует машиночитаемые выгрузки — ровно для того, чтобы их скармливали языковым моделям:
Файл | Что это | Размер |
| вся документация одним markdown-файлом, страницы размечены маркерами | ~4.9 МБ, 228 страниц |
| индекс всех страниц по разделам: заголовок, канонический URL, однострочное описание | ~43 КБ |
Сервер скачивает эти два файла (условными запросами по ETag/Last-Modified),
кладёт в кэш, разбирает на страницы и фрагменты по заголовкам и строит BM25-индекс
в памяти. Никакого парсинга HTML, приватных эндпоинтов и обхода защит: только
официальный экспорт, документация под MIT.
Текст, который возвращают инструменты, — это сторонняя документация. Для агента это данные для чтения, а не инструкции к исполнению.
Related MCP server: Hermes Docs MCP Server
Инструменты
Два инструмента — контракт, который ждут удалённые коннекторы (в том числе
ChatGPT/Deep Research): search находит адресуемые фрагменты, fetch отдаёт
страницу за любым из них.
Инструмент | Назначение |
| поиск по документации; возвращает до 8 фрагментов с |
| страница целиком в markdown: |
id фрагмента — это путь/страницы#N, например user-guide/features/mcp#3.
fetch принимает и его, и путь страницы, и полный URL документации, и точный
заголовок.
Про язык запроса. Документация Hermes Agent англоязычная, а поиск здесь лексический (BM25), не семантический: русский запрос не найдёт ничего. Поэтому инструмент просит модель формулировать запрос по-английски, а на пустую выдачу с кириллицей отвечает подсказкой перевести запрос и повторить. Отвечает пользователю ассистент всё равно по-русски.
Установка
Для разработки:
cd hermes-docs-mcp
uv sync
uv run hermes-docs-mcp # stdioДля использования из Claude — см. «Подключение» ниже: рантайм ставится отдельно,
вне ~/Desktop, ~/Documents и ~/Downloads.
macOS: Claude запускает MCP-серверы без доступа к этим трём папкам. venv, лежащий там, умирает ещё до старта Python:
PermissionError: Operation not permitted: .../.venv/pyvenv.cfg, затемFatal Python error: init_import_site. Репозиторий может лежать где угодно — важно только, где стоит рантайм.
Первый вызов любого инструмента, которому нужна документация, скачает выгрузки (~5 МБ). Дальше всё работает из кэша; сеть нужна только при обновлении.
Подключение
Claude Code
Проектный .mcp.json рядом с репозиторием:
{
"mcpServers": {
"hermes-docs": {
"command": "/Users/вы/hermes-docs-mcp/.venv/bin/hermes-docs-mcp",
"args": []
}
}
}Чтобы Claude Code не спрашивал подтверждение, добавьте "enabledMcpjsonServers": ["hermes-docs"]
в .claude/settings.local.json проекта.
Claude Desktop
./scripts/install-desktop-config.shСкрипт собирает wheel, ставит его в ~/hermes-docs-mcp/.venv (путь меняется
через HERMES_DOCS_MCP_PREFIX) и прописывает этот бинарь в конфиг. Идемпотентен,
делает бэкап конфига, отказывается ставить рантайм в папку, закрытую от Claude.
Запускайте при полностью закрытом Claude (Cmd+Q). Приложение держит
claude_desktop_config.jsonв памяти и перезаписывает файл, пока работает, стирая записи, добавленные в обход него, — проверено, в пределах десяти секунд.
Hermes Agent
В ~/.hermes/config.yaml:
mcp_servers:
hermes-docs:
command: uv
args: ["--directory", "/opt/hermes-docs-mcp", "run", "hermes-docs-mcp"]Агент, который умеет искать по собственной документации, сам находит нужные флаги,
ключи конфигурации и форматы SOUL.md вместо того, чтобы угадывать их.
Деплой как удалённый коннектор
Локальный сервер работает только на той машине, где запущен. Чтобы коннектор появился во всех клиентах сразу — в вебе, на телефоне, на других компьютерах — его нужно где-то запустить и подключать по URL.
В репозитории есть render.yaml: в Render → New → Blueprint укажите этот
репозиторий, и сервис поднимется с нужными переменными. URL коннектора —
https://<имя-сервиса>.onrender.com/mcp/ (слэш в конце желателен), транспорт —
Streamable HTTP, авторизации нет.
Что важно понимать про такой инстанс:
он отдаёт публичную документацию и ничего больше: ни файлов, ни секретов, ни пользовательских данных;
аутентификации клиентов у сервера нет, поэтому бинд за пределы loopback требует явного
HERMES_DOCS_MCP_ALLOW_PUBLIC_BIND=1— случайно не выставится;обновлять документацию наружу нечем: инстанс сам перечитывает выгрузки по истечении
HERMES_DOCS_MCP_TTL, но не чаще одного раза вHERMES_DOCS_MCP_MIN_REFRESHсекунд (по умолчанию 300) — превратить его в кнопку «скачай пять мегабайт» не получится;на free-плане Render сервис засыпает без запросов — первый вызов после сна будет дольше обычного.
Настройки (переменные окружения)
Переменная | По умолчанию | Смысл |
|
| источник выгрузок; только https (http — лишь для loopback) |
|
| где лежит кэш; можно подсунуть заранее заполненный каталог |
|
| через сколько секунд кэш считается устаревшим |
|
| таймаут HTTP, секунды |
| не задана |
|
|
|
|
| не задана |
|
|
| внешний адрес инстанса: с ним иконка отдаётся ссылкой, без него — инлайном. На Render подставляется сам |
|
| минимальный интервал между обновлениями доки, секунды |
|
| только для HTTP-транспортов; |
HTTP-транспорты по умолчанию разрешены только на loopback: у сервера нет аутентификации клиентов. Выставить наружу можно, но только осознанно — см. «Деплой как удалённый коннектор» выше.
Полностью офлайн (например, закрытый VPS)
mkdir -p /opt/hermes-docs-cache
curl -fsSL -o /opt/hermes-docs-cache/llms-full.txt https://hermes-agent.nousresearch.com/llms-full.txt
curl -fsSL -o /opt/hermes-docs-cache/docs-llms.txt https://hermes-agent.nousresearch.com/docs/llms.txt
export HERMES_DOCS_MCP_CACHE_DIR=/opt/hermes-docs-cache HERMES_DOCS_MCP_OFFLINE=1Разработка
uv run pytest -q
uv run ruff check .Тесты работают на локальных фикстурах и поднятом на loopback HTTP-сервере;
сеть для них не нужна. Отдельная проверка по «живому» сайту включается флагом
HERMES_DOCS_MCP_LIVE=1.
Лицензия
MIT (код сервера). Сама документация Hermes Agent принадлежит Nous Research и распространяется по условиям их репозитория (MIT). Проект неофициальный.
Available Tools
2 toolsfetchA
Возвращает страницу документации Hermes Agent целиком в markdown.
Принимает id из результатов search — и путь страницы («user-guide/features/mcp»), и id фрагмента с суффиксом («…/mcp#3»), и полный URL страницы документации. Страницы бывают объёмными, поэтому зови только когда фрагментов из search действительно не хватает, а не на каждый результат.
Inputs: id (required).
searchA
Поиск по официальной документации Hermes Agent (228 страниц, на английском).
Зови этот инструмент на любой вопрос про Hermes Agent — установку, настройку, конфигурацию, инструменты, память, скиллы, MCP, мессенджеры, безопасность, развёртывание. Примеры: «как поставить Hermes на сервер», «что писать в SOUL.md», «как подключить Telegram», «какие есть режимы approvals», «чем skills отличаются от memory», «как настроить cron», «как запустить в Docker», «какие провайдеры моделей поддерживаются», «как дать агенту доступ к MCP».
Документация англоязычная, а поиск лексический — формулируй запрос по-английски, даже если пользователь спросил по-русски («как подключить телеграм» → «connect telegram bot gateway»). Отвечать пользователю можно на его языке.
Возвращает фрагменты страниц с адресом id, заголовком, ссылкой и текстом. Отвечай по ним и ссылайся на url; за полной страницей вызывай fetch.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: search returns relevant fragments from the documentation, while fetch retrieves a full page in markdown. Their descriptions explicitly state when to use each, leaving no ambiguity for an agent.
Both tool names are single, simple verbs (search, fetch) that directly describe their actions. This consistent minimalist pattern is predictable and easy to remember.
With only 2 tools, the server feels slightly thin for a documentation MCP, though the scope is narrow and focused on search + retrieval. According to the calibration, 1-2 tools is borderline, but each tool clearly earns its place.
The pair of search and fetch covers the core documentation lookup workflow well: find relevant fragments, then fetch the full page if needed. A minor gap is the lack of direct browsing or listing of documentation sections, but agents can work around this via search.
Maintenance
Related MCP Connectors
One place for every AI agent's pages and docs: versioned links to share, search and update.
Verified doc corpora for agents: grep-first retrieval, hashed pages, Merkle+RFC-3161 receipts
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
Shared knowledge base for AI agents. Semantic search across agents, no setup required — just a URL.
Related MCP Servers
- MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to search, navigate, and read the complete Hermes Agent documentation through a local SQLite FTS5 index, with tools for full-text search, page reading, and browsing documentation structure.MIT
- AlicenseNot gradedqualityCmaintenanceEnables agents to search, retrieve, and list Hermes Agent documentation locally, version-matched to the installed commit, with fallback to GitHub when no local checkout exists.MIT

Anahita MCPofficial
AlicenseAqualityBmaintenanceEnables MCP clients to search and read Anahita's documentation and API reference locally, so agents can answer current questions about setup, federation, routes, parameters, and response shapes, including offline from cached copies.621 npm1MIT