hermes agent可通过四种方式扩展功能：一、基于mcp协议开发外部工具插件；二、编写内置python工具模块；三、利用acp适配器对接现有自动化平台；四、构建cli扩展命令。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望增强Hermes Agent的原生能力，使其支持自定义工具、对接私有服务或集成第三方API，则需通过插件机制扩展其功能。Hermes Agent 提供标准化的 MCP（Model Control Protocol）接口与插件注册机制，允许开发者以模块化方式注入新能力。以下是具体实施路径：
一、基于 MCP 协议开发外部工具插件
MCP 是 Hermes Agent 官方定义的轻量级工具通信协议，用于解耦 Agent 核心与外部工具执行器。所有插件需实现 MCP Server 接口，并在运行时向 Agent 注册可用操作列表。
1、创建 Python 项目目录，初始化 mcp-server.py 入口文件。
2、使用官方 mcp-sdk-python 库构建服务端，调用 mcp.server.stdio.StdIoServer 启动监听。
3、定义工具函数并用 @tool 装饰器标注，确保参数类型为 JSON 可序列化类型。
4、在 tools.json 中声明工具元信息，包括名称、描述、输入 Schema 和输出 Schema。
5、启动插件服务后，通过 hermes tool register --url http://localhost:8080 将其注册至本地 Agent 实例。
二、开发内置 Python 工具模块
对于无需网络通信、可直接在 Agent 进程内执行的逻辑，推荐编写内置工具模块。该方式性能更高，且能直接访问 Agent 的内存上下文与日志系统。
1、在 ~/.hermes/tools/ 目录下新建 Python 文件，如 my_notifier.py。
2、在文件中定义类，继承 BaseTool，重写 execute() 方法。
3、在类内使用 self.agent.memory 读取跨会话记忆，或调用 self.agent.logger.info() 记录执行轨迹。
4、将该文件路径添加至 ~/.hermes/config.yaml 的 tools.enabled 列表中。
5、重启 Agent 或执行 hermes tool reload 命令使新工具生效。
三、通过 ACP 适配器接入现有自动化平台
ACP（Automation Control Protocol）适配器是 Hermes Agent 内置的桥接模块，专用于对接已有的 RPA、Home Assistant、Node-RED 等平台。它将外部系统的动作抽象为标准工具调用，无需重写业务逻辑。
1、确认目标平台已启用 HTTP API 或 WebSocket 接口，并获取基础认证凭证。
2、复制 hermes-agent/acp_adapter/examples/homeassistant.py 模板，修改 BASE_URL 与 ACCESS_TOKEN 字段。
3、在模板中定义 get_tools() 方法，返回适配后的工具列表，每个工具对应一个平台设备或服务动作。
4、将适配器文件软链接至 ~/.hermes/acp/ 目录。
5、运行 hermes acp enable homeassistant 启用该适配器，Agent 将自动加载其暴露的所有工具。
四、构建 CLI 扩展命令
CLI 扩展命令允许用户通过 hermes
1、在 ~/.hermes/cli/ 下新建 backup_memory.py 文件。
2、定义 register() 函数，使用 argparse.ArgumentParser 配置子命令参数。
3、在函数中调用 hermes.runtime.get_agent_instance() 获取当前运行实例，访问其 memory.store 属性执行序列化导出。
4、将文件名（不含扩展名）添加至 ~/.hermes/config.yaml 的 cli.extensions 数组。
5、执行 hermes backup-memory --output /tmp/mem_20260416.json 即可触发该扩展逻辑。
