hermes-mcp-bridge

Model Context Protocol (MCP) server for Hermes Agent.

Connects MCP-compatible clients (Cursor, Claude Desktop, Antigravity, Windsurf) to local or remote Hermes instances.

Features

• Shell execution: Run bash commands in the workspace (exec_command).

• History & inspection: Read conversation transcripts, tool outputs, and token counts from Hermes's SQLite database (get_conversation, search_conversation, list_sessions, list_profiles).

• Run control: Send messages, send slash commands, cancel active runs, and release stuck leases (send_message, steer_agent, cancel_run, get_agent_status, clear_stuck_lease, restart_gateway).

• Git operations: Check status, diffs, logs, commit changes, and switch branches (git_status, git_diff, git_log, git_commit, git_checkout).

• File operations: Read and write workspace files (read_file, write_file).

Related MCP server: CodePier

Installation

Requires Python 3.10+.

git clone https://github.com/shakilapr/hermes-mcp-bridge.git
cd hermes-mcp-bridge
pip install .

For development:

pip install -e ".[dev]"

Configuration

Configure using environment variables:

MCP Client Configuration

Local Hermes

Add to your MCP client configuration (claude_desktop_config.json, Cursor MCP settings, etc.):

{
  "mcpServers": {
    "hermes": {
      "command": "hermes-mcp",
      "env": {
        "HERMES_HOME": "/path/to/.hermes"
      }
    }
  }
}

Remote Hermes (over SSH)

Runs locally and connects to Hermes on a remote server through SSH. No bridge installation required on the server.

{
  "mcpServers": {
    "hermes": {
      "command": "hermes-mcp",
      "env": {
        "HERMES_SSH_HOST": "user@your-server-ip",
        "HERMES_SSH_KEY": "/path/to/id_ed25519",
        "HERMES_REMOTE_HOME": "/root/.hermes"
      }
    }
  }
}

Running the Server Directly

Stdio mode (default for MCP):

hermes-mcp

SSE mode (HTTP server):

hermes-mcp --transport sse --port 8000

Testing

pytest

License

MIT