关于 hermes-atlas-mcp
hermes-atlas-mcp 将 Hermes Atlas 社区目录提供给兼容 MCP 的客户端,面向探索 Hermes Agent 工具、技能、插件及集成的用户。它从 hermesatlas.com 实时获取目录数据,并在内存中缓存一小时。
主要功能
- 01按关键词搜索项目
- 02获取项目摘要与元数据
- 03按分类浏览精选列表
- 04读取指南与比较内容
- 05向 Atlas 提交自由问答
适用场景
- 01查找 Hermes Agent 的记忆提供方
- 02查看特定项目的介绍和链接
- 03浏览某一类别的精选项目
- 04询问生态指南或项目差异
MCP 相关
提供五种 MCP 工具用于搜索、查询目录项目、获取指南和提出问题,并公开目录、摘要、精选列表及生态概览等资源。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
5收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | |
| query | string | 是 | |
| category | string | 否 |
详细介绍
hermes-atlas-mcp
MCP 服务将 Hermes Atlas 生态系统目录——为 Nous Research 的 Hermes Agent 构建的 100 多款社区工具、技能、插件、记忆提供方、工作区和集成——开放给任何兼容 MCP 的客户端(Claude Desktop、Cursor、Continue、Windsurf 等)。
你可以向 AI 助手提出以下问题:
- “在 Hermes Atlas 中搜索记忆提供方”
- “hermes-atlas 目录对 hermes-agent 项目有何介绍?”
- “列出适用于 Hermes Agent 的热门技能”
- “获取 Hermes 入门指南”
- “询问 atlas:Hermes Agent 和 Claude Code 有什么区别?”
所有目录数据均从 hermesatlas.com 实时获取(在内存中缓存 1 小时),因此工具的回答反映的是当前生态系统,而非过时的快照。
状态: 0.x,实验阶段。1.0 之前可能会有不兼容变更。每周批量发布。
安装
推荐 — 一条命令
npx -y hermes-atlas-mcp install --client claude-desktop
根据需要将 claude-desktop 替换为 cursor 或 claude-code。安装程序会为你的操作系统找到对应的配置文件,在不影响其他 MCP 服务的情况下合并 hermes-atlas 条目,并告知你接下来要做什么。
其他标志:
--print— 试运行(显示差异,不写入任何内容)--force— 不提示,覆盖现有的hermes-atlas条目
移除:
npx -y hermes-atlas-mcp uninstall --client claude-desktop
运行任一命令后,都要完全退出并重新打开客户端(仅关闭窗口还不够——需要重启进程)。
手动安装(如果安装程序无法运行)
Claude Desktop
找到配置文件:
- 最简单的方法: 打开 Claude Desktop,前往 Settings → Developer → Edit Config。配置文件会在默认编辑器中打开。
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
如果文件为空或不存在,请粘贴以下内容;否则,将 hermes-atlas 条目合并到现有的 mcpServers 对象中:
{
"mcpServers": {
"hermes-atlas": {
"command": "npx",
"args": ["-y", "hermes-atlas-mcp"]
}
}
}
保存。完全退出 Claude Desktop,然后重新打开。工具选择器中会显示五个工具。
Cursor
文件:~/.cursor/mcp.json(全局)或 .cursor/mcp.json(按项目)。使用上文相同的 JSON 片段。
Claude Code
可以使用上文的安装程序,也可以在 Claude Code 中运行 /mcp 并通过其界面添加,或者手动编辑 ~/.claude.json。
从源码安装
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
工具
| 工具 | 功能 |
|---|---|
search_projects | 对目录进行排序后的关键词搜索。可选 category 筛选条件。 |
get_project | 获取一个 owner/repo 的完整摘要、元数据和 URL。 |
list_by_category | 获取六个精选列表之一中的排序项目。 |
get_guide | 获取入门指南、安装指南或与 Claude Code 对比的完整文本。 |
ask_atlas | 将自由形式的 RAG 问题发送到网站的 /api/chat 端点。 |
资源
| URI | 内容 |
|---|---|
hermes-atlas://repos | 完整目录 JSON |
hermes-atlas://summaries | AI 生成的摘要 JSON |
hermes-atlas://lists | 精选列表 JSON |
hermes-atlas://ecosystem | ECOSYSTEM.md 概览(Markdown) |
开发
npm install
npm run dev # tsc --watch
npm run build # tsc
npm start # runs dist/index.js on stdio
许可证
MIT © Kevin Simback。目录数据采用 CC0 许可。
相关项目
- hermesatlas.com — 线上网站
- ksimback/hermes-ecosystem — 网站背后的源代码仓库
- Hermes Agent — 该生态系统围绕其构建的 Agent
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。