Skip to main content
Glama
hermes-mcp-server

hermes-mcp-server

by pangtongya

šŸ”Œ Hermes MCP Server

Expose 100+ Hermes Agent skills to any MCP-compatible AI client.

Connect Claude Desktop, Cursor, Continue, Zed, or any MCP client to Hermes Agent's powerful toolkit.

PyPI version License: MIT Sponsor MCP


✨ What You Get

Install one MCP server, get ALL these tools in your AI client:

Category

Tools

🌐 Web

Search, extract, navigate, scrape

šŸ–„ļø Browser

Full headless browser — click, type, scroll, screenshot

šŸ’» Terminal

Execute shell commands, run Python code

šŸ“ Files

Read, write, search files (ripgrep-backed)

šŸ™ GitHub

Repo info, search, create issues, manage PRs

šŸ“š Research

arXiv search, YouTube transcripts, blog monitoring

šŸ“ Productivity

Notion, Google Workspace, Linear, Airtable

šŸŽØ Creative

Image generation, ASCII art, diagrams, music

šŸ¤– AI

Full Hermes Agent reasoning — multi-step, tool-using


Related MCP server: superskills-mcp

šŸš€ Quick Start

1. Install

pip install hermes-mcp-server

2. Start Hermes Agent

# Start Hermes Agent with HTTP API enabled
hermes serve --http --port 8080

3. Configure your MCP client

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "hermes": {
      "command": "hermes-mcp",
      "args": ["--endpoint", "http://localhost:8080"],
      "env": {
        "HERMES_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / Continue / Zed:

{
  "mcpServers": {
    "hermes": {
      "command": "hermes-mcp",
      "args": ["--endpoint", "https://your-hermes-instance.com"]
    }
  }
}

4. Restart your MCP client and start using Hermes tools!


šŸ“‹ Complete Tool List

Tool

Description

web_search

Google/Bing web search with snippets

web_extract

Extract clean content from any URL

browser_navigate

Headless browser navigation

browser_snapshot

Get page accessibility tree

browser_click

Click elements by ref ID

terminal_exec

Execute shell commands

code_execute

Run Python code with Hermes SDK

file_read

Read files with line numbers

file_write

Create/overwrite files

file_search

Ripgrep-powered file/content search

github_repo_info

Get GitHub repo details

github_search_repos

Search GitHub repos

github_create_issue

Create GitHub issues

arxiv_search

Search academic papers

youtube_transcript

Get YouTube transcripts

notion_search

Search Notion workspace

image_generate

AI image generation

ai_complete

Full Hermes Agent reasoning

80+ more tools coming soon — all 100+ Hermes skills will be exposed.


🐳 Docker

docker run -e HERMES_ENDPOINT=http://host.docker.internal:8080 \
           ghcr.io/pangtongya/hermes-mcp-server:latest

šŸ’° Monetization

Hermes MCP Server is free and open-source. Revenue comes from:

Tier

Price

Includes

šŸ†“ Community

Free

Self-hosted, all tools, community support

⭐ Pro

$5/mo

Priority support, hosted Hermes endpoint, 1000 req/day

šŸ¢ Team

$29/mo

5 seats, hosted endpoint, 10000 req/day, Slack support

šŸš€ Enterprise

Custom

Dedicated instance, SSO, SLA, unlimited requests

Become a Sponsor →


šŸ—ļø Architecture

ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”     MCP Protocol     ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”     HTTP      ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
│  Claude Desktop  │◄────────────────────►│  Hermes MCP       │◄────────────►│  Hermes Agent     │
│  Cursor / Zed    │   (stdio / JSON-RPC) │  Server           │   (REST API)  │  100+ Skills     │
│  Continue / etc  │                      │  (Python)         │              │  Tools + Models  │
ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜                      ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜              ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜

šŸ”§ Configuration

Environment Variable

Default

Description

HERMES_ENDPOINT

http://localhost:8080

Hermes Agent HTTP endpoint

HERMES_API_KEY

(none)

API key for authentication


šŸ› ļø Development

git clone https://github.com/pangtongya/hermes-mcp-server.git
cd hermes-mcp-server
pip install -e ".[dev]"

# Run tests
pytest

# Run locally
python -m hermes_mcp.cli --endpoint http://localhost:8080

šŸ“„ License

MIT Ā© pangtongya


⭐ Star History

If this project helps you, please consider sponsoring or giving it a ⭐!

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers