hermes-mcp-bridge

Registers external MCP servers with Hermes Agent via CLI commands.

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill hermes-mcp-bridge-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-mcp-bridge
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/devops/hermes-mcp-bridge
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill hermes-mcp-bridge-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Hermes Agent blocks direct edits to its config files as a security guard, so adding an external MCP server (like ComfyUI or a remote API) by hand fails. This Skill provides the correct CLI-based workflow to register, enable, and verify MCP servers without touching protected configuration. ## Core Features & Use Cases - CLI-based registration: Add MCP servers with hermes mcp add, including non-interactive confirmation piping and connect-timeout tuning. - Failure recovery: Diagnose and fix common pitfalls such as servers saved as enabled: false after a failed first test, and false failures caused by first-run npx package downloads. - Independent verification: A raw MCP stdio handshake probe (references/verify_handshake.py) confirms initialize and tools/list responses when hermes mcp test returns an empty error. - Use Case: Connect a ComfyUI instance running on a gaming PC over Tailscale by registering comfyui-mcp with Hermes, re-enabling it, and confirming 185 tools are discovered. ## Quick Start Register the ComfyUI MCP server with Hermes using the CLI, re-enable it if the first test failed, and verify the connection with the handshake probe.

Frequently Asked Questions about hermes-mcp-bridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add an MCP server to Hermes Agent?▼

Use the CLI command `hermes mcp add <name> --command npx --args -y <pkg>@latest --connect-timeout 60`, piping `echo y` to confirm non-interactively. Then run `hermes mcp test <name>` and restart Hermes, since MCP servers are discovered only at startup.

Why can't I edit the Hermes config.yaml file directly?▼

Hermes blocks `patch` and `write_file` from modifying files under `~/.hermes/**` with the error "Agent cannot modify security-sensitive configuration". Use `hermes mcp add` and `hermes config set` CLI commands instead of direct file edits.

Why does hermes mcp test fail with an empty error?▼

The first `npx -y pkg@latest` run downloads the package, which can exceed the connect timeout and produce an empty error even when the config is correct. Re-run `hermes mcp test` after the package is cached, or verify independently with a raw MCP handshake probe.

How do I fix an MCP server stuck at enabled false in Hermes?▼

Run `hermes config set mcp_servers.<name>.enabled true --force`. Hermes saves a server as disabled when the first `mcp test` fails, so it must be re-enabled manually before restarting.

Does hermes mcp add support targeting a specific profile?▼

No, there is no `--profile` flag. The command writes to whichever profile is currently active, so run it under the intended profile and verify with `grep -n <name> ~/.hermes/profiles/<profile>/config.yaml`.