Hermes Agent MCP на Mac: dev-инструменты (2026)
Hermes Agent (Nous Research, MIT) подключает внешние инструменты через MCP — filesystem, GitHub, Codex — в ~/.hermes/config.yaml.
Зачем MCP в Hermes на Mac
Клиент: mcp_servers. Сервер: hermes mcp serve для Cursor.
Сначала: установка Hermes на Mac.
Архитектура MCP
| Компонент | Путь | Роль |
|---|---|---|
| Конфиг | ~/.hermes/config.yaml | Серверы MCP |
| Секреты | ~/.hermes/.env | Ключи |
7 шагов настройки MCP на macOS
Шаг 1 — Проверка MCP-зависимостей
Стандартный install.sh включает MCP. Если hermes doctor предупреждает:
cd ~/.hermes/hermes-agent && uv pip install -e ".[mcp]"
Проверьте node --version и npx --version.
Шаг 2 — Filesystem для одного репозитория
В ~/.hermes/config.yaml добавьте mcp_servers.project_fs с реальным путём проекта:
npx -y @modelcontextprotocol/server-filesystem /Users/you/dev/my-app (не монтируйте весь $HOME).
Шаг 3 — GitHub из каталога
hermes mcp или hermes mcp install github — токен в ~/.hermes/.env, в чеклисте отключите опасные tools.
Шаг 4 — Опционально: preset Codex
Если codex в PATH: hermes mcp add codex --preset codex.
Шаг 5 — Белый список tools
Задайте tools.include и tools.prompts: false, чтобы регистрировались только нужные mcp_github_*.
Шаг 6 — Проверка в TUI
Запустите hermes, попросите список файлов в корне проекта. После правок YAML: /reload-mcp. OAuth — в новом терминале: hermes mcp login <server> (автоперезагрузка в сессии — 30 с).
Шаг 7 — Hermes для Cursor
Добавьте "command": "hermes", "args": ["mcp", "serve"] в MCP-конфиг клиента. Чтение без gateway; отправка требует hermes gateway — см. установку Hermes.
Сценарии
| Сценарий | Транспорт | Конфиг |
|---|---|---|
| Репозиторий | stdio | filesystem |
| GitHub | stdio | catalog |
| Codex | preset | codex |
| Linear | HTTP | OAuth |
stdio для локальной разработки; HTTP OAuth для Linear; Mac mini 24/7 — ограничьте stdio-процессы.
Устранение неполадок
MCP-сервер не подключается
Симптом: ошибки подключения, нет mcp_* tools в TUI.
Исправление: uv pip install -e ".[mcp]", затем hermes doctor. Проверьте YAML mcp_servers:.
Инструменты не появляются
Симптом: установка прошла, агент не вызывает MCP.
Причины: enabled: false, узкий tools.include, незавершённый OAuth. Запустите hermes mcp configure github когда сервер доступен.
OAuth на удалённом Mac (SSH)
Симптом: браузер на ноутбуке, Hermes на headless Mac.
Исправление: вставьте redirect URL или ssh -L; hermes mcp login в интерактивной SSH-сессии.
FAQ
hermes mcp serve). Можно использовать Cursor для IDE и Hermes для каналов или mcp_servers для репозитория.mcp_<server>_<tool> (точки → подчёркивания). Опишите задачу на естественном языке — модель выберет tool.optional-mcps/ проходят PR-ревью, но install запускает upstream bootstrap. Читайте source: в manifest перед продакшеном.supports_parallel_tool_calls: true на сервер — только для read-only или без конфликтов записи.hermes update снова hermes mcp install <name>; новые tools — через hermes mcp configure.