Skip to main content
Glama
pangtongya

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


🚀 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 ⭐!

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pangtongya/hermes-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server