🏠 Главная › Документация › Гайды

Использование MCP с Hermes

Это руководство показывает, как на практике использовать MCP с Hermes Agent в повседневных рабочих процессах.

Если страница возможностей объясняет, что такое MCP, то это руководство — о том, как быстро и безопасно получить от него пользу.

Когда следует использовать MCP?

Используйте MCP, когда:

Не используйте MCP, когда:

Ментальная модель

Думайте о MCP как о слое-адаптере:

Последний пункт важен. Хорошее использование MCP — это не просто «подключить всё». Это «подключить нужное с минимальной полезной поверхностью».

Шаг 1: установка поддержки MCP

Если вы установили Hermes с помощью стандартного скрипта установки, поддержка MCP уже включена (установщик выполняет uv pip install -e ".[all]").

Если вы установили без дополнительных пакетов и вам нужно добавить MCP отдельно:

cd ~/.hermes/hermes-agent
uv pip install -e ".[mcp]"

Для npm-серверов убедитесь, что Node.js и npx доступны.

Для многих Python MCP-серверов uvx является удобным выбором по умолчанию.

Шаг 2: сначала добавьте один сервер

Начните с одного безопасного сервера.

Пример: доступ к файловой системе только для одного каталога проекта.

mcp_servers:
  project_fs:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/my-project"]

Затем запустите Hermes:

hermes chat

Теперь задайте что-нибудь конкретное:

Inspect this project and summarize the repo layout.

Шаг 3: проверьте загрузку MCP

Вы можете проверить MCP несколькими способами:

Практический тестовый запрос:

Tell me which MCP-backed tools are available right now.

Шаг 4: начинайте фильтрацию сразу

Не откладывайте на потом, если сервер предоставляет много инструментов.

Пример: разрешить только то, что нужно

mcp_servers:
  github:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "***"
    tools:
      include: [list_issues, create_issue, search_code]

Обычно это лучший вариант по умолчанию для чувствительных систем.

WSL2: мост между Hermes в WSL и Chrome на Windows

Это практическая настройка, когда:

В этой конфигурации Hermes не подключается к Chrome напрямую. Вместо этого:

Ментальная модель:

Hermes (WSL) -> MCP stdio bridge -> Windows Chrome

Почему этот режим полезен

Используйте chrome-devtools-mcp.

Если ваш Chrome на Windows уже имеет включённую удалённую отладку через chrome://inspect/#remote-debugging, добавьте его из WSL следующим образом:

hermes mcp add chrome-devtools-win --command cmd.exe --args /c npx -y chrome-devtools-mcp@latest --autoConnect --no-usage-statistics

После сохранения сервера:

hermes mcp test chrome-devtools-win

Затем запустите новую сессию Hermes или выполните:

/reload-mcp

Типичный запрос

После загрузки Hermes может напрямую использовать инструменты браузера с префиксом MCP. Например:

调用 MCP 工具 mcp_chrome_devtools_win_list_pages，列出当前浏览器标签页。

Когда /browser connect — неподходящий инструмент

Если Hermes работает в WSL, а Chrome — на Windows, /browser connect может не сработать, даже если Chrome открыт и доступен для отладки.

Распространённые причины:

В таких случаях оставьте /browser connect для настроек в одной среде и используйте MCP для моста WSL-to-Windows для браузера.

Известные проблемы

Пример: блокировка опасных действий

mcp_servers:
  stripe:
    url: "https://mcp.stripe.com"
    headers:
      Authorization: "Bearer ***"
    tools:
      exclude: [delete_customer, refund_payment]

Пример: отключение вспомогательных обёрток

mcp_servers:
  docs:
    url: "https://mcp.docs.example.com"
    tools:
      prompts: false
      resources: false

На что на самом деле влияет фильтрация?

В Hermes есть две категории функциональности, предоставляемой через MCP:

  1. Собственные MCP-инструменты сервера

  2. фильтруются с помощью:

  3. tools.include

  4. tools.exclude

  5. Вспомогательные обёртки, добавляемые Hermes

  6. фильтруются с помощью:

  7. tools.resources
  8. tools.prompts

Вспомогательные обёртки, которые вы можете увидеть

Ресурсы:

Промпты:

Эти обёртки появляются только если:

Таким образом, Hermes не будет делать вид, что у сервера есть ресурсы/промпты, если их нет.

Типовые шаблоны

Шаблон 1: локальный помощник проекта

Используйте MCP для файловой системы или git-сервера в рамках репозитория, когда хотите, чтобы Hermes работал в ограниченном пространстве.

mcp_servers:
  fs:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/project"]

  git:
    command: "uvx"
    args: ["mcp-server-git", "--repository", "/home/user/project"]

Хорошие запросы:

Review the project structure and identify where configuration lives.

Check the local git state and summarize what changed recently.

Шаблон 2: помощник для сортировки задач GitHub

mcp_servers:
  github:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "***"
    tools:
      include: [list_issues, create_issue, update_issue, search_code]
      prompts: false
      resources: false

Хорошие запросы:

List open issues about MCP, cluster them by theme, and draft a high-quality issue for the most common bug.

Search the repo for uses of _discover_and_register_server and explain how MCP tools are registered.

Шаблон 3: помощник для внутреннего API

mcp_servers:
  internal_api:
    url: "https://mcp.internal.example.com"
    headers:
      Authorization: "Bearer ***"
    tools:
      include: [list_customers, get_customer, list_invoices]
      resources: false
      prompts: false

Хорошие запросы:

Look up customer ACME Corp and summarize recent invoice activity.

Это как раз тот случай, когда строгий белый список гораздо лучше чёрного.

Шаблон 4: серверы документации / знаний

Некоторые MCP-серверы предоставляют промпты или ресурсы, которые больше похожи на общие активы знаний, чем на прямые действия.

mcp_servers:
  docs:
    url: "https://mcp.docs.example.com"
    tools:
      prompts: true
      resources: true

Хорошие запросы:

List available MCP resources from the docs server, then read the onboarding guide and summarize it.

List prompts exposed by the docs server and tell me which ones would help with incident response.

Учебный пример: настройка «от начала до конца» с фильтрацией

Вот практическая последовательность действий.

Фаза 1: добавьте GitHub MCP с жёстким белым списком

mcp_servers:
  github:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "***"
    tools:
      include: [list_issues, create_issue, search_code]
      prompts: false
      resources: false

Запустите Hermes и спросите:

Search the codebase for references to MCP and summarize the main integration points.

Фаза 2: расширяйте только по необходимости

Если позже вам также понадобится обновление задач:

tools:
  include: [list_issues, create_issue, update_issue, search_code]

Затем перезагрузите:

/reload-mcp

Фаза 3: добавьте второй сервер с другой политикой

mcp_servers:
  github:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "***"
    tools:
      include: [list_issues, create_issue, update_issue, search_code]
      prompts: false
      resources: false

  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/project"]

Теперь Hermes может комбинировать их:

Inspect the local project files, then create a GitHub issue summarizing the bug you find.

Вот где MCP становится мощным: многосистемные рабочие процессы без изменения ядра Hermes.

Рекомендации по безопасному использованию

Отдавайте предпочтение белым спискам для опасных систем

Для всего, что связано с финансами, работой с клиентами или деструктивными действиями:

Отключайте неиспользуемые утилиты

Если вы не хотите, чтобы модель просматривала ресурсы/промпты, предоставленные сервером, отключите их:

tools:
  resources: false
  prompts: false

Держите серверы узконаправленными

Примеры:

Перезагружайте после изменений конфигурации

/reload-mcp

Делайте это после изменения:

Поиск и устранение неисправностей по симптомам

«Сервер подключается, но ожидаемые инструменты отсутствуют»

Возможные причины:

«Сервер настроен, но ничего не загружается»

Проверьте:

«Почему я вижу меньше инструментов, чем рекламирует MCP-сервер?»

Потому что Hermes теперь учитывает вашу политику для каждого сервера и регистрацию с учётом возможностей. Это ожидаемо и обычно желательно.

«Как удалить MCP-сервер без удаления конфигурации?»

Используйте:

enabled: false

Это сохраняет конфигурацию, но предотвращает подключение и регистрацию.

Хорошие первые серверы для большинства пользователей:

Не очень хорошие первые серверы: