Hermes Agent 扩展全目录：195 个 Skill、99 个 Plugin 与 20 个 MCP

前言：当一个项目同时出现 Skill、Plugin、MCP，很容易把“源码里带着”误解成“安装后全都启用”。这篇文章不挑代表项：我以 Hermes Agent 源码提交 59795c4 为边界，逐项整理 80 个 Bundled Skill（内置技能）、115 个 Optional Skill（可选技能）、99 份 Plugin Manifest（插件清单）、20 个官方可选 MCP，以及 Hermes 自身 MCP Server 暴露的 10 个工具。

系列导航：这组文章按“总览 → 入口 → 运行时 → 扩展 → 状态 → 协作 → 安全”的顺序展开；第一次阅读可以从总览开始，带着具体问题也可以直接跳到专题。

1. 01｜Hermes Agent 架构总览：从 Agent Loop 到智能体平台
2. 02｜Hermes Desktop 架构：Electron 如何连接本地 Python Agent
3. 03｜Hermes Agent 运行时：AIAgent、模型协议与工具执行
4. 04｜Hermes Agent 扩展体系：Skill、Plugin 与 MCP
5. 05｜实战：同一个 Markdown 检查器的 Skill、Plugin 与 MCP 三种实现
6. 06｜Hermes Agent 的持续学习系统：Memory、Review、Skill 与 Curator
7. 07｜Hermes Agent 的长会话架构：Prompt Cache、压缩与 SessionDB
8. 08｜Hermes Agent 的多 Agent 与自动化：从 Goal 到 Kanban
9. 09｜Hermes Agent 安全架构：审批、沙箱、回滚与凭据隔离
10. 10｜Hermes Agent 扩展全目录：195 个 Skill、99 个 Plugin 与 20 个 MCP

先把“自带”这个词拆开

下面五组内容都在官方仓库或由仓库生成的目录中，但它们的激活方式不同。仓库包含（shipped）不等于运行时启用（enabled），尤其不要把 Optional Skill 和 Optional MCP 写成默认工具。

版本边界：数量与名称来自 2026-08-20 的源码提交 59795c40fff95b3029b8f2b02164da892429070f。在线文档可能滞后于仓库自动生成目录，因此本文把当前提交中的目录文件、plugin.yaml 和 optional-mcps/ 作为最终依据。

三条扩展路径怎样进入一次 Agent 回合

flowchart LR
    U[用户任务
User Task] --> A[智能体循环
Agent Loop]
    A --> SI[技能摘要索引
Skill Summary Index]
    SI -->|按需读取 skill_view| SB[技能正文进入上下文
Skill Body in Context]
    A --> PR[进程内插件注册表
In-process Plugin Registry]
    PR --> TR[工具与生命周期钩子
Tools and Lifecycle Hooks]
    A --> MC[MCP 客户端
MCP Client]
    MC -->|初始化与工具发现
initialize + tools/list| MS[外部 MCP 服务器
External MCP Server]
    MS -->|工具 Schema| A
    A -->|工具调用 Tool Call| TR
    A -->|执行工具调用
tools/call| MS
    SB --> A
    TR -->|工具结果 Tool Result| A
    MS -->|JSON 结果或错误| A
    A --> R[最终回复
Final Response]

Skill 的输入输出不是固定 RPC 契约：它向模型提供步骤、约束和示例，真正输入是当前任务上下文，输出可能是文本、文件或后续工具调用。Plugin 是受信任的进程内 Python 扩展，既能注册工具，也能注册模型 Provider、消息平台、记忆 Provider、Hook 等能力。MCP 则是协议边界：Host 先初始化连接并发现工具，再按 Server 声明的 JSON Schema 发送 tools/call；感觉像调用远程插件或 HTTP API，但底层传输也可以是本地 stdio。

80 个 Bundled Skill：安装时随 Hermes 同步

以下每一行都来自当前 skills-catalog.md。输入输出是该类别的典型契约，不是 Hermes 强制的 JSON Schema；真正细节仍以对应 SKILL.md 为准。

115 个 Optional Skill：官方提供，但默认不激活

这些 Skill 位于 optional-skills/，必须显式安装。它们常依赖额外 CLI、账号、硬件或较窄的专业场景，因此没有塞进所有用户的默认发现面。

# 列出当前可用技能 / List currently available skills
hermes skills list

# 安装一个官方可选技能 / Install an official optional skill
hermes skills install official/mcp/fastmcp

# 卸载已安装的可选技能 / Uninstall an installed optional skill
hermes skills uninstall fastmcp

# 列出当前可用技能 / List currently available skills
hermes skills list

# 安装一个官方可选技能 / Install an official optional skill
hermes skills install official/mcp/fastmcp

# 卸载已安装的可选技能 / Uninstall an installed optional skill
hermes skills uninstall fastmcp

99 个 Plugin：不只是工具插件

统计单位是当前 plugins/ 下带 plugin.yaml 的插件。Plugin Manager（插件管理器）发现清单后处理依赖、配置与启用状态；插件 Python Module（插件 Python 模块）拿到 PluginContext（插件上下文，通常简称 ctx），通过它向作用域注册表注册 Tool、Hook、Provider 等组件。ctx 不是神秘协议，而是 Hermes 传给插件的受控注册接口和运行环境。

sequenceDiagram
    participant PM as 插件管理器
Plugin Manager
    participant MF as 插件清单
plugin.yaml Manifest
    participant PY as 插件 Python 模块
Plugin Python Module
    participant CTX as 插件上下文
PluginContext (ctx)
    participant REG as 作用域注册表
Scoped Registry
    PM->>MF: 扫描、校验版本与依赖
Discover and validate
    PM->>PY: 导入启用的入口模块
Import enabled entrypoint
    PM->>CTX: 创建当前会话作用域
Create session scope
    PY->>CTX: 注册组件
register(...)
    CTX->>REG: 注册工具、Hook 或 Provider
Register tool, hook, or provider
    REG-->>PM: 可分派组件
Dispatchable component

还有 2 个没有 plugin.yaml 的 Dashboard-only Extension

20 个 Optional MCP：连接之后才会成为工具

MCP 的发现分两层：Hermes 先从配置/目录知道“应该启动或连接哪个 Server”，完成 initialize 协商；随后向 Server 调用 tools/list，把返回的工具名、描述和 inputSchema 加入 Tool Registry（工具注册表）。模型选择工具后，Hermes 发送 tools/call，Server 返回文本、结构化数据、资源或协议错误。远程 HTTP/SSE 项通常还要走 OAuth；本地 stdio 项由 Hermes 启动子进程，通过标准输入输出交换 MCP 消息。

MCP 注册与调用时序

sequenceDiagram
    participant H as Hermes MCP 客户端
Hermes MCP Client
    participant S as MCP 服务器
MCP Server
    participant R as 工具注册表
Tool Registry
    participant M as 大模型
LLM
    H->>S: initialize（协议与能力协商）
    S-->>H: 服务器信息与能力
serverInfo + capabilities
    H->>S: tools/list（工具发现）
    S-->>H: 名称、描述与输入 Schema
name + description + inputSchema
    H->>R: 注册带命名空间的工具
Register namespaced tools
    R-->>M: 可用工具 Schema
Available tool schemas
    M->>H: Tool Call（工具调用）
    H->>S: 按名称和参数调用工具
tools/call(name, arguments)
    S-->>H: 文本内容、结构化内容或错误
content / structuredContent / error
    H-->>M: Tool Result（工具结果）

反过来：Hermes 自身也能充当 MCP Server

这条方向容易和“让 Hermes 调用外部 MCP”混淆。执行 hermes mcp-server 后，其他兼容 MCP 的 Host 可以把 Hermes Gateway 当作 Server，访问会话、消息、附件、事件和审批。当前源码暴露下面 10 个工具。

# 查看插件状态与诊断 / Inspect plugin state and diagnostics
hermes plugins list
hermes plugins doctor

# 查看 MCP 配置 / Inspect MCP configuration
hermes mcp list

# 把 Hermes Gateway 暴露为 MCP Server / Expose Hermes Gateway as an MCP server
hermes mcp-server

# 查看插件状态与诊断 / Inspect plugin state and diagnostics
hermes plugins list
hermes plugins doctor

# 查看 MCP 配置 / Inspect MCP configuration
hermes mcp list

# 把 Hermes Gateway 暴露为 MCP Server / Expose Hermes Gateway as an MCP server
hermes mcp-server

怎么选：先看你要改变哪一层

一句话记忆：Skill 是“把方法装进上下文”，Plugin 是“把组件装进 Hermes 进程”，MCP 是“通过协议连接进程外能力”。目录再长，判断边界仍然只需要看：谁发现它、代码在哪个进程执行、输入输出是否由 Schema 约束。

参考资料与源码入口

• Hermes Agent 源码快照 59795c4
• Bundled Skills Catalog（内置技能目录）
• Optional Skills Catalog（可选技能目录）
• Skills System（技能发现与加载）
• Plugins（插件系统）
• Built-in Plugins（官方插件说明）
• Plugin 源码目录
• MCP Servers（配置、发现与调用）
• Optional MCP 源码目录
• Hermes MCP Server 源码

题图来源：《阿尔卑斯湖、群山与全景》，创作者 derwiki，来自 Pixabay；依据 Pixabay Content License（Pixabay 内容许可）使用。

回到系列起点：Hermes Agent 架构总览：从 Agent Loop 到智能体平台