{"_id":"@bkuri/hermes-atlas-mcp","name":"@bkuri/hermes-atlas-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@bkuri/hermes-atlas-mcp","version":"0.1.0","description":"MCP server for the Hermes Atlas ecosystem directory — discover tools, skills, plugins, and integrations for Hermes Agent","type":"module","main":"dist/index.js","bin":{"hermes-atlas-mcp":"dist/index.js","hermes-atlas-install":"dist/install-embeddings.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","install:embeddings":"node dist/install-embeddings.js"},"keywords":["mcp","hermes","atlas","ai-agent","nous-research"],"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"_id":"@bkuri/hermes-atlas-mcp@0.1.0","gitHead":"4ac7de20f190bc286d3a5765099fb5c9ca1c42a1","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"11.1.0","dist":{"integrity":"sha512-0epRY92yW/oOAqiJ5jvobdTBhN7Ir5iwwaT4IAZTw5wLsuBL7vJXg3WpUBrU8fMH9QpUBcV8dVPsPDVryp/nEw==","shasum":"5f2ecef4363adde319d8dfd07582c89081016677","tarball":"https://registry.npmjs.org/@bkuri/hermes-atlas-mcp/-/hermes-atlas-mcp-0.1.0.tgz","fileCount":31,"unpackedSize":629039,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGVs6ULtBTLDUe/CAc2zdZmBfhb3HY2s/zrcYKUX+uDDAiEAi9maJZ5i5m7zAzcMtd5KKcvyCNkv6NsJbrQiWJy7xSg="}]},"_npmUser":{"name":"bkuri","email":"npmjs.com@bkuri.com"},"directories":{},"maintainers":[{"name":"bkuri","email":"npmjs.com@bkuri.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/hermes-atlas-mcp_0.1.0_1781761720484_0.487744095154637"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-18T05:48:40.264Z","0.1.0":"2026-06-18T05:48:40.679Z","modified":"2026-06-18T05:48:41.010Z"},"maintainers":[{"name":"bkuri","email":"npmjs.com@bkuri.com"}],"description":"MCP server for the Hermes Atlas ecosystem directory — discover tools, skills, plugins, and integrations for Hermes Agent","keywords":["mcp","hermes","atlas","ai-agent","nous-research"],"license":"MIT","readme":"# 🗺️ Hermes Atlas MCP Server\n\n**MCP server for the [Hermes Atlas](https://hermesatlas.com) ecosystem directory** — gives AI agents instant access to 169+ quality-filtered tools, skills, plugins, and integrations for [Hermes Agent](https://github.com/NousResearch/hermes-agent).\n\n## Why?\n\nHermes Agent has a massive and growing ecosystem. This MCP server turns that ecosystem into **instant expandability** — agents can discover, compare, and recommend tools without leaving their conversation.\n\n## Quick Start\n\nAdd to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"hermes-atlas\": {\n      \"command\": \"npx\",\n      \"args\": [\"hermes-atlas-mcp\"]\n    }\n  }\n}\n```\n\nOr with Docker/stdio:\n\n```json\n{\n  \"mcpServers\": {\n    \"hermes-atlas\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/hermes-atlas-mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | Description | Example |\n|------|-------------|---------|\n| `search_repos` | Full-text search across 169 repos | `search_repos(\"memory persistence\")` |\n| `list_categories` | Browse 12 ecosystem categories | `list_categories()` |\n| `get_repo` | Detailed repo info + AI summary | `get_repo(\"NousResearch/hermes-agent\")` |\n| `recommend` | **Match tools to your use case** | `recommend(\"I need to deploy on K8s\")` |\n| `get_featured` | Trending/rising repos this week | `get_featured()` |\n| `get_lists` | Curated lists overview | `get_lists()` |\n| `get_list` | Specific curated list with per-repo descriptions | `get_list(\"best-memory-providers\")` |\n| `ecosystem_stats` | Aggregate stats, category breakdown, latest version | `ecosystem_stats()` |\n| `ask_atlas` | RAG over research knowledge base *(requires embeddings)* | `ask_atlas(\"How do skills work?\")` |\n\n## Optional: Local Embeddings\n\nThe `ask_atlas` tool provides RAG-powered answers grounded in 27 research files (6,500+ chunks) covering Hermes Agent installation, architecture, skills system, deployment, and best practices.\n\nInstall the embeddings (~70MB) separately:\n\n```bash\nnpx hermes-atlas-mcp install-embeddings\n# or equivalently:\nnpx hermes-atlas-install\n```\n\nThe server auto-detects the embeddings at startup and adds the `ask_atlas` tool when available. Without embeddings, all other tools work perfectly using the summaries index.\n\n## How It Works\n\n```\n┌────────────────────────────────────────────┐\n│           hermes-atlas-mcp                │\n│                                            │\n│  ┌──────────┐  ┌──────────────┐           │\n│  │ repos    │  │ summaries    │           │\n│  │ (169)    │  │ (AI-generated│  ← bundled │\n│  └────┬─────┘  │  per-repo)  │  or fetched│\n│       │        └──────────────┘           │\n│  ┌────┴──────────────────────┐             │\n│  │ lists, featured, stats   │ ← cached    │\n│  └───────────────────────────┘   (4hr TTL) │\n│                                            │\n│  ┌───────────────────────────┐  optional   │\n│  │ chunks.json (70MB)        │ ← install   │\n│  │ RAG knowledge base        │   separately│\n│  └───────────────────────────┘             │\n└────────────────────────────────────────────┘\n          │\n    stdio (MCP)\n```\n\n- **Zero-config**: Works immediately with no API keys needed\n- **Offline-capable**: Bundled data works without network; fresh data fetched in background\n- **Light**: Core data is ~300KB; embeddings are opt-in at 70MB\n- **Fast**: Full-text search and recommendations complete in <50ms\n\n## Data Sources\n\nAll data sourced from [ksimback/hermes-ecosystem](https://github.com/ksimback/hermes-ecosystem) — a community-curated directory security-reviewed before inclusion.\n\n| File | Size | Content |\n|------|------|---------|\n| `repos.json` | 60KB | 169 repos — owner, name, description, stars, category, official flag |\n| `summaries.json` | 189KB | AI-generated summaries + highlights per repo |\n| `lists.json` | 2KB | 6 curated lists (best memory, top skills, deployment, etc.) |\n| `list-summaries.json` | 26KB | Per-repo descriptions within each curated list |\n| `featured.json` | 241B | Currently featured/trending repos |\n| `latest-release.json` | 374B | Latest Hermes Agent version |\n| `chunks.json` | 70MB | 6,554 research chunks with pre-computed embeddings *(optional)* |\n\n## Development\n\n```bash\ngit clone https://github.com/your-user/hermes-atlas-mcp.git\ncd hermes-atlas-mcp\nnpm install\nnpm run build\n\n# Test interactively\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"test\",\"version\":\"0.1\"}}}' | npm start\n\n# Watch mode\nnpm run dev\n```\n\n## License\n\nMIT. Data sourced from [hermes-ecosystem](https://github.com/ksimback/hermes-ecosystem) (MIT/CC BY 4.0).\n","readmeFilename":"README.md","_rev":"1-a4c40b1cd4a12acd4ed9212b075ce1ff"}