Hermes Plant — Agent Commerce Assurance

Hermes Plant MCP 服务

可运行的 MCP 服务及集成示例，适用于 Hermes Plant——一个 Agent Commerce Assurance 层，可让 AI Agent 预检、批准并证明影响重大的操作。先进行一次费用为 1 美分的操作安全检查，仅将高风险操作转入签名审查证据流程，并通过 x402 按次付费。

内容：一个可运行的 stdio MCP 桥接服务，供注册表爬虫和本地客户端使用；此外还有可直接使用的 curl、TypeScript、Python、CrewAI、LangChain 示例，以及适用于 Claude Desktop / Cline / Cursor 的 MCP 客户端配置。

在上线前审查一个工作流

Agent 获准执行某项操作后，参数发生了变化；超时后重试还可能导致操作执行两次。如何将审批与最终操作绑定、防止重复执行，并证明操作是否已完成？

示例发现备忘录 通过一个虚构示例，介绍这些漏洞、现有证据和按优先级排序的修复计划。这仅为演示，并非客户案例。

对于已拥有可运行或即将上线的 Agent 的技术创始人和自动化服务机构，300 美元的工作流审查 涵盖一个工作流、一份工作流图、按优先级排序的发现，以及一份实用的修复计划。最多三小时的时间包括通话、准备、备忘录撰写和一轮问题澄清。我们会在收费前以书面形式确认范围和时间安排。实施工作和生产环境访问需要另行签订协议。

安装 Action Safety 技能

为 Codex、Claude Code、Cursor 和其他兼容 Agent Skills 的客户端安装公开的 fail-closed Action Safety 技能：

npx [email protected] add JesseGdotIO/hermesplant-mcp-server --skill protect-agent-action

该技能会在执行确切的重大操作前调用费用为 1 美分的快速检查，将检查结果绑定到未更改的操作，并且只有在额外的 0.25 美元费用获准时，才会升级处理高风险或严重风险操作。审查分流绝不会被视为人工审批，该技能也绝不会扩大调用方的权限。

源代码：skills/protect-agent-action · 安装指南和信任边界

使用托管 MCP 连接器

如需使用完整的生产工具集，请使用 Glama 上的官方 Hermes Plant — Agent Commerce Assurance 连接器。它通过实时 Streamable HTTP 端点提供 Action Safety、Spend Assurance、签名证据、支付策略检查，以及各项 x402 工具。

本仓库是一个便携式、无需密钥的发现桥接服务。它让注册表爬虫和本地客户端无需签署钱包消息或花费资金，即可查看实时目录和支付合约。托管连接器则是买方调用生产工具的入口。

Glama 注册表

此仓库经过配置，可供 Glama 在无需密钥或有资金的钱包的情况下构建和检查 MCP 服务：

• glama.json 声明 GitHub 维护者。
• 根目录中的 Dockerfile 会启动 mcp-server/ 中的 stdio MCP 服务。
• npm run smoke:mcp 会列出所有本地 MCP 工具，并获取实时 x402 清单。
• GitHub Actions 会使用实际依赖项验证 MCP 服务、Docker 镜像、Shell 示例，以及无需花费资金的 TypeScript/Python 客户端契约。

发布 Glama 版本仍需在账户端操作，而非通过 GitHub 发布。认领 Glama 中的服务后，请使用 Dockerfile 管理页面部署构建，等待构建测试通过，然后发布 Glama 版本。该版本会启用 Glama 的服务一致性和工具定义质量评分。

互补的 MCP 服务

Hermes Plant 负责管理具有重大影响的操作和付款；以下独立服务覆盖 Agent 技术栈中相邻的层：

• SINT Protocol — 在执行前进行能力授权和策略实施。
• AgentPay MCP — 提供带有支出限额和审批队列的非托管钱包执行能力。
• Agent Security Scanner MCP — 扫描代码仓库、软件包、提示词和技能的安全性。

这些链接描述的是功能互补关系，并不代表合作伙伴关系或背书。

从保障工作流开始

工作流	用途	跟踪入口
操作安全	对 Shell、Git、SQL、部署、x402 和 MCP 操作进行预检；将高风险工作升级为审核并生成签名回执。	打开工作流
支出保障	在 Agent 支出前检查付款策略、钱包上下文和证据。	打开工作流
投资证据	运行确定性承销，并通过一次付费调用返回可验证的证据。	打开工作流

使用免费 API 密钥每月最多调用 250 次；规律使用可选择每月 $29 的 Agent API Pass，也可在 Base 上按次使用 USDC 付款。公开证明和机器可读契约见 hermesplant.com/proof 和 hermesplant.com/openapi.json。

组件目录

以下 19 个托管的 x402 端点仍可作为可组合工具使用：

端点	用途	托管路径
DealAnalyzer	DCF、IRR、XIRR、NPV	/agent-services/dealanalyzer
Waterfall	LP/GP 私募股权分配瀑布	/agent-services/waterfall
Options	Black-Scholes 定价 + Greeks	/agent-services/options
Bond	收益率、久期、凸性	/agent-services/bond
CashflowLens	现金流预测 + 敏感性分析	/agent-services/cashflowlens
PortfolioGuard	投资组合风险评分	/agent-services/portfolioguard
WalletGuard	钱包 AML + 制裁筛查	/agent-services/walletguard
EmailGuard	邮件信誉 + 风险	/agent-services/emailguard
DestructGuard	阻止 AI Agent 执行破坏性命令	/agent-services/destructguard
MCP risk	连接前评估 MCP 服务风险	/agent-services/mcp-risk
Evidence	付费调用的证据包	/agent-services/evidence
Payment policy	检查/评估 x402 支付策略	/agent-services/payment-policy
ReviewQueue	人工参与的审批路由	/agent-services/reviewqueue

Agent 可通过 OpenAPI、llms.txt、x402 清单、API 目录、MCP 元数据或 Agent 技能发现端点。上方的工作流链接将此 GitHub 仓库标记为其来源；实际的 Glama 收录使用独立的注册表标签。来源标签仅用于观察，不能证明买家身份或交易已完成。

x402 调用的工作方式

Client                    Hermes Plant                 Facilitator
  |                            |                            |
  | POST /endpoint             |                            |
  |--------------------------->|                            |
  | 402 Payment Required       |                            |
  | + PAYMENT-REQUIRED         |                            |
  |<---------------------------|                            |
  | sign payment locally       |                            |
  | POST /endpoint             |                            |
  | + PAYMENT-SIGNATURE        |                            |
  |--------------------------->| verify signature           |
  |                            |--------------------------->|
  |                            | ok                         |
  |                            |<---------------------------|
  | 200 OK + result            | settle payment             |
  |<---------------------------|--------------------------->|

1. 客户端发起 HTTP 请求。
2. 服务端返回 402 Payment Required，并附带 PAYMENT-REQUIRED 标头，其中包含价格、网络、资产、收款方和超时时间。
3. 客户端解析质询，在本地签署 USDC 转账授权，然后在请求中加入 PAYMENT-SIGNATURE 标头并重新发送。
4. 服务端通过 facilitator 验证签名、执行任务、在链上结算款项，并返回 200 OK，其中包含结果和 PAYMENT-RESPONSE 标头。

完整规范见 github.com/x402-foundation/x402。

发现入口

这些入口让任何 Agent 或用户都能自行完成接入，无需协助：

• hermesplant.com/llms.txt - 面向 Agent 的可读目录
• hermesplant.com/openapi.json - 完整的 OpenAPI 3.1
• hermesplant.com/.well-known/x402 - x402 清单，包含 facilitator、网络、资产、价格和 payTo 元数据
• hermesplant.com/.well-known/api-catalog - RFC 9727 风格的 API 目录
• hermesplant.com/.well-known/mcp/server-card.json - MCP 服务描述
• hermesplant.com/mcp - 可流式传输的 HTTP MCP 端点

本仓库中的 MCP 工具

可运行的 stdio 服务会提供五个只读发现工具：

工具	用途
hermesplant_x402_manifest	在付费调用前获取实时 x402 清单。
hermesplant_llms_catalog	获取供 Agent 读取的 llms.txt 目录。
hermesplant_api_catalog	获取机器可读的 API 目录。
hermesplant_mcp_server_card	获取托管 MCP 服务描述信息。
hermesplant_list_hosted_tools	检查托管的 Streamable HTTP MCP 端点，并列出其公布的工具。

这些本地工具不会签署钱包消息、批准交易、调用付费端点或花费 USDC。它们提供客户端在调用托管付费工具前所需的发现层。

快速开始

选择与你的技术栈匹配的运行环境：

运行环境	文件夹	备注
curl / Bash	curl/	纯 Shell；适合检查 402 握手
TypeScript	typescript/	使用 @x402/fetch + @modelcontextprotocol/sdk
Python	python/	使用 x402 包
CrewAI	crewai/	调用 Hermes 端点的金融 Agent 团队
LangChain	langchain/	封装 Hermes 的 LangChain Tool
MCP 配置	mcp-config/	可一次粘贴到 Claude Desktop / Cline / Cursor 的配置
MCP 服务	mcp-server/	可运行的 stdio MCP 桥接程序，用于发现、检查服务卡片和列出托管工具

在本地运行 MCP 服务

npm install
npm run smoke:mcp
npm start

MCP 服务注册表构建

本仓库包含根目录下的 glama.json 和 Dockerfile，供 MCP 注册表爬虫使用：

docker build -t hermesplant-mcp-server .
docker run --rm -i hermesplant-mcp-server

容器会启动 mcp-server/ 中的 stdio MCP 桥接程序，提供 Hermes Plant 发现工具和托管 MCP 元数据，无需 API 密钥。

示例来源标签

curl、TypeScript、Python、CrewAI 和 LangChain 的 CashflowLens 示例会发送 x-hermes-channel: github-mcp-repo、x-hermes-medium: repository 和 x-hermes-campaign: first-workflow。x-hermes-content 用于标识运行环境。 付费客户端会将这些标头传入 x402 请求，以便 SDK 在 402 挑战后重试时保留这些标头。Curl 只检查未付费挑战。

如果你在其他位置发布示例，请将这些标签替换为对应位置的来源和营销活动。标签是调用方声明的观察信息；它们不会验证买家身份、收入或非关联客户。所有者 QA 还必须发送 x-hermes-probe: 1，以便从获客报告中排除相关请求。

钱包设置

受保护的付费调用示例要求：

• 在 Base 主网上有已充值的钱包，链 ID 为 8453。
• 有足够的 USDC 支付所选端点的费用，并准备少量 ETH 用于 Gas。
• 设置 EVM_PRIVATE_KEY，并明确选择启用 HERMES_ALLOW_PAYMENT=1。

随附的 CashflowLens 客户端将支付要求上限设为 $0.20 USDC，且只注册 Base 主网。导入和测试时请勿设置启用选项。切勿提交私钥。这些生产示例不声称支持测试网；如需进行测试网集成，请使用 x402 测试资源服务器。

状态

这些示例面向 hermesplant.com 的生产部署。端点签名可能会发生变化，因此上线前请对照 openapi.json 和 /.well-known/x402 清单进行检查。

贡献

欢迎提交问题和 PR。想支持新的运行环境或框架？提交一个包含可运行示例且 README 简洁明了的 PR。

许可证

MIT——详见 LICENSE。