如何用 MCP 让本地 Hermes Agent 对话式管理 Hermes Cloud 实例列出、启停、查费用【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agentHermes Cloud 托管运行 Hermes Agent 实例默认你要在 Nous Portal 的/agents页面里管理它们。如果你的本地 Hermes Agent 连上 Portal 的 MCP 服务器就可以直接在终端里用自然语言完成这些事“列出我的云实例”“把停掉的那个重启”“这个实例大概花多少钱”不需要离开终端去点网页。本文覆盖连接、验证和日常使用的完整路径适用前提是你已有可访问 Hermes Cloud 的 Nous Portal 账号且本地机器上装着 Hermes Agent标准安装脚本已包含 MCP 支持否则需先补装见下文。准备条件一个 Nous Portal 账号且能访问 Hermes Cloud至少有一个实例或具备创建实例的权限。本地 Hermes Agent 已装好 MCP 支持。标准安装脚本会自动装好如果不是手动补装cd ~/.hermes/hermes-agent uv pip install -e .[mcp]不需要额外的 API key 或 client secret该服务器走 OAuth 2.1带 PKCE登录就是一次浏览器跳转用的就是你 Portal 已有的账号。第一步添加 MCP 服务器hermes mcp add --url https://portal.nousresearch.com/mcp --auth oauth hermes-cloud--auth oauth告诉 Hermes 这是一个带 OAuth 保护的 HTTP 服务器。首次连接时 Hermes 会自动完成四件事自动发现服务器的 OAuth 端点RFC 9728 / 8414 元数据以客户端身份向服务器注册RFC 7591 动态客户端注册——没有 secret 需要你复制打开浏览器让你登录 Portal 并授权把得到的 token 存到~/.hermes/mcp-tokens/下并复用过期后自动刷新。如果你的 Portal 账号属于多个组织授权时浏览器会弹出一个组织选择器选这个连接要管理哪个组织即可——选择只在浏览器里做命令行不用传参单组织账号会自动绑定跳过这一步。以后想换绑到另一个组织删除后重新添加即可hermes mcp remove hermes-cloud hermes mcp add --url https://portal.nousresearch.com/mcp --auth oauth hermes-cloud第二步验证连接先在终端验证连接本身hermes mcp test hermes-cloud然后启动或重载一个会话让工具注册进来hermes chat在会话里执行/reload-mcp再问一个只读问题确认工具真的可用List my Hermes Cloud agents and their current status.预期结果是拿回与 Portal/agents页面一致的实例列表。Hermes 会报告每个工具的实际返回值你可以据此判断操作是否真正落到了云上。第三步日常对话式操作连接完成后模型可以在你的 Hermes Cloud 组织上调用两组工具你想让它做的事底层工具“列出我的云实例”agentslist“name现在什么状态”agentsget / status“这个实例大概花多少钱”agentscost_estimate“启动 / 停止 / 重启name”agentstart / stop / restart“新建一个叫name的实例”agentcreate“销毁name”agentdestroy“更新name的环境变量 / 镜像”agentupdate_env / update_image对应的直接问法示例实例名research-bot、scratch是文档示例替换成你自己的名字Which of my cloud agents is currently running, and roughly what is each one costing?Restart the instance called research-bot.Create a new Hermes Cloud instance named scratch, then tell me when its ready.每次调用都以你的 Portal 身份跑在你的组织上且每次调用都会重新检查成员资格——这个连接只能碰你本来就能在网页端管理的实例。可选分支只读模式如果只想要“列出、查看”绝不让它 start/stop/create/destroy可以把连接限制在agents这一个只读工具上。编辑~/.hermes/config.yamlmcp_servers: hermes-cloud: url: https://portal.nousresearch.com/mcp auth: oauth tools: include: [agents]改完配置后在会话里执行/reload-mcp生效。完整的 include/exclude 过滤模型见 Use MCP with Hermes。配置落点执行hermes mcp add之后服务器配置写在~/.hermes/config.yamlmcp_servers: hermes-cloud: url: https://portal.nousresearch.com/mcp auth: oauth凭据不进config.yaml——OAuth token 单独存放在~/.hermes/mcp-tokens/下auth: oauth字段含义等完整字段说明见 MCP Config Reference。常见问题排查连接时报 “invalid_client” 或 “unknown client”说明本地缓存的客户端注册和服务器对不上了比如你之前连过别的环境。需要清掉这个服务器的 OAuth 缓存状态再重新添加。下面命令会删除该服务器在~/.hermes/mcp-tokens/下的 token 文件仅限hermes-cloud这一个服务器的缓存之后需要重新走一遍浏览器登录hermes mcp remove hermes-cloud rm -f ~/.hermes/mcp-tokens/hermes-cloud.* hermes mcp add --url https://portal.nousresearch.com/mcp --auth oauth hermes-cloud工具添加后没出现先在会话里重载并检查/reload-mcpTell me which MCP-backed tools are available right now.仍然没有的话跑hermes mcp test hermes-cloud它会直接显示连接错误。被要求重新登录OAuth token 会自动刷新但如果 Portal 那边作废了你的会话改密码、吊销、过期下一次调用就会要求重新授权。重新执行一遍hermes mcp add命令即可浏览器流程会重新签发 token。在 SSH / 无图形界面的远程主机上OAuth 的浏览器回调监听在 Hermes 所在的那台机器上。远程主机有两种完成方式详见 OAuth over SSH / Remote Hosts交互终端里直接把浏览器重定向后的完整 URL 粘贴回 Hermes 的提示符无需任何配置或者开一条 SSH 本地端口转发ssh -N -L port:127.0.0.1:port userremote-host端口以 Hermes 打印的Waiting for callback on ...行为准。另外注意如果在运行中的会话里通过编辑config.yaml添加 OAuth MCP 服务器CLI 的自动重载只有 30 秒超时不够完成交互式 OAuth应改用hermes mcp login server单独完成登录它没有这个限制最多等 5 分钟。下一步Use MCP with Hermes——MCP 服务器连接与过滤的通用做法MCP 功能总览——MCP 是什么、Hermes 如何使用它Nous Portal——同一个登录背后的订阅、模型与 Tool Gateway。【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考