sidebar_position: 6 title: "Use MCP with Hermes" description: "A practical guide to connecting MCP servers to Hermes Agent, filtering their tools, and using them safely in real workflows" lang: ru

Используйте MCP с Гермесом

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

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

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

Используйте MCP, когда: - инструмент уже существует в форме MCP, и вы не хотите создавать собственный инструмент Hermes - вы хотите, чтобы Hermes работал с локальной или удаленной системой через чистый уровень RPC - вам нужен детальный контроль воздействия на каждый сервер - вы хотите подключить Hermes к внутренним API, базам данных или системам компании без изменения ядра Hermes

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

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

Думайте о 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 chat

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

Inspect this project and summarize the repo layout.

Шаг 3: проверьте, загружен ли MCP

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

• Баннер/статус Hermes должен показывать интеграцию MCP при настройке.
• спросите Гермеса, какие инструменты у него есть в наличии
• используйте /reload-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]

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

Пример: опасные действия в черный список

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

Обертки утилит, которые вы можете увидеть

Ресурсы: - list_resources - read_resource

Подсказки: - list_prompts - get_prompt

Эти оболочки появляются только в том случае, если: - ваша конфигурация это позволяет, и - сеанс сервера MCP фактически поддерживает эти возможности

Таким образом, 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

Запустите Гермес и спросите:

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.include - начните с минимально возможного набора

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

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

tools:
  resources: false
  prompts: false

Сохраняйте узкую область действия серверов

Примеры: - Сервер файловой системы привязан к одному каталогу проекта, а не ко всему домашнему каталогу - сервер git указал на одно репо - внутренний сервер API с доступом к инструментам с большим объемом чтения по умолчанию

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

/reload-mcp

Сделайте это после изменения: - включать/исключать списки - включенные флаги - ресурсы/подсказки переключаются - заголовки аутентификации / env

Устранение неполадок по признаку

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

Возможные причины: - отфильтровано tools.include - исключен tools.exclude - Обертки утилит отключены через resources: false или prompts: false - сервер фактически не поддерживает ресурсы/подсказки

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

Проверьте: - enabled: false не осталось в конфиге - существует команда/время выполнения (npx, uvx и т. д.) - Конечная точка HTTP доступна - окружение аутентификации или заголовки верны

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

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

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

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

enabled: false

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

Рекомендуемые первые настройки MCP

Хорошие первые серверы для большинства пользователей: - файловая система - мерзавец - Гитхаб - выборка/документация серверов MCP - один узкий внутренний API

Не очень хорошие первые сервера: - гигантские бизнес-системы с множеством деструктивных действий и отсутствием фильтрации - все, что вы не понимаете достаточно хорошо, чтобы сдерживать

Связанные документы

• MCP (Протокол контекста модели)
• Часто задаваемые вопросы
• Команды слэша