Back to Directory/Developer Tools

io.github.ksimback/hermes-atlas-mcp

Search and fetch 100+ Hermes Agent tools, skills, plugins, and integrations from hermesatlas.com.

Developer ToolsJavaScriptv0.2.0

hermes-atlas-mcp

MCP server exposing the Hermes Atlas ecosystem catalog — 100+ community-built tools, skills, plugins, memory providers, workspaces, and integrations for Nous Research's Hermes Agent — to any MCP-aware client (Claude Desktop, Cursor, Continue, Windsurf, etc.).

Ask your AI assistant things like:

  • "Search Hermes Atlas for memory providers"
  • "What does the hermes-atlas catalog say about the hermes-agent project?"
  • "List the top skills for Hermes Agent"
  • "Get the Hermes beginner's guide"
  • "Ask the atlas: what's the difference between Hermes Agent and Claude Code?"

All catalog data is fetched live from hermesatlas.com (cached in-memory for 1 hour), so tool answers reflect the current ecosystem, not a stale snapshot.

Status: 0.x, experimental. Breaking changes may happen before 1.0. Batch releases weekly.

Install

Recommended — one command

npx -y hermes-atlas-mcp install --client claude-desktop

Replace claude-desktop with cursor or claude-code as needed. The installer finds the right config file for your OS, merges in the hermes-atlas entry without touching your other MCP servers, and tells you what to do next.

Other flags:

  • --print — dry-run (shows the diff, writes nothing)
  • --force — overwrite an existing hermes-atlas entry without prompting

To remove:

npx -y hermes-atlas-mcp uninstall --client claude-desktop

Fully quit and reopen the client after either command (closing the window isn't enough — the process needs to restart).

Manual install (if the installer won't work)

Claude Desktop

Find the config file:

  • Easiest: open Claude Desktop, go to Settings → Developer → Edit Config. The file opens in your default editor.
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Paste this (if the file is empty or doesn't exist) or merge the hermes-atlas entry into your existing mcpServers object:

{
  "mcpServers": {
    "hermes-atlas": {
      "command": "npx",
      "args": ["-y", "hermes-atlas-mcp"]
    }
  }
}

Save. Fully quit Claude Desktop and reopen. The five tools appear in the tool picker.

Cursor

File: ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project). Same JSON snippet as above.

Claude Code

Either use the installer above, or run /mcp inside Claude Code and add through its UI, or hand-edit ~/.claude.json.

From source

git clone https://github.com/ksimback/hermes-atlas-mcp.git
cd hermes-atlas-mcp
npm install
npm run build
node dist/index.js    # stdio server, pipe JSON-RPC to test

Tools

ToolWhat it does
search_projectsRanked keyword search over the catalog. Optional category filter.
get_projectFull summary + metadata + URL for one owner/repo.
list_by_categoryRanked projects in one of the six curated lists.
get_guideFull text of the beginner's guide, install guide, or vs-Claude-Code comparison.
ask_atlasFree-form RAG question routed to the site's /api/chat endpoint.

Resources

URIContent
hermes-atlas://reposFull catalog JSON
hermes-atlas://summariesAI-generated summaries JSON
hermes-atlas://listsCurated lists JSON
hermes-atlas://ecosystemECOSYSTEM.md overview (markdown)

Development

npm install
npm run dev     # tsc --watch
npm run build   # tsc
npm start       # runs dist/index.js on stdio

License

MIT © Kevin Simback. Catalog data is CC0.

Related

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y hermes-atlas-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-ksimback-hermes-atlas-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hermes-atlas-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

hermes-atlas-mcpnpm

Compatible MCP Clients

io.github.ksimback/hermes-atlas-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More