mcpField
A
Agent Commerce Guard

Agent Commerce Guard

远程服务
github.com/fxjim安全013 周前更新
代码仓库

关于 Agent Commerce Guard

Agent Commerce Guard 为可能消费资金或执行公开操作的 Agent 提供策略审查和审批流程，并提供只读远程 MCP 服务、CLI、技能及 CI 评估方式。

主要功能

  1. 01审查拟议的商业操作
  2. 02返回决策和所需证据
  3. 03提供只读远程 MCP 工具
  4. 04支持 CLI、技能和 GitHub Action
  5. 05购买流程要求明确批准

适用场景

  1. 01执行前预检 Agent 操作
  2. 02在 CI 中审查公开操作清单
  3. 03核对商业任务的策略和证据要求

MCP 相关

远程 MCP 服务提供只读的 `review_agent_commerce_actions` 工具和公开报价 JSON 资源。`review-before-purchase` 提示词将策略审查、报价查看、批准及收据验证串联起来，但不会发起付款。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://agent-commerce-guard.vercel.app/api/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

1
参数类型必填说明
actionsarray是要审核的操作。请勿提交机密信息、私有源代码或客户数据。

详细介绍

Agent Commerce Guard

为能够花钱、销售服务、在社交平台发帖、发行代币、公开部署或操作钱包的 AI Agent 提供审批关卡和回执。

Agent Commerce Guard 是一个本地优先的命令行工具和技能包，适用于为自主 Agent 添加 x402、ACP、钱包、卖家运行时、付费 API 或社交集成功能的开发者。

Agent Commerce Guard 预览

GitHub Action 冒烟测试 Agent Skills 安装量

试用免费评估器 | 预览付费套餐 | 添加 GitHub Action | 以 1 USDC 购买私有套餐 | 获取支持

在线评估器包含钱包支出、生产环境部署、代币发行和市场任务的一键预设，因此无需先编写清单即可测试每条决策路径。

免费托管预检私有本地套餐
适用场景公开 CI Action 清单私有或敏感的 Agent 工作流
执行方式托管评估器，最多 5 个操作 / 20 KB本地命令行工具、HTTP 评估器、技能、策略和模板
价格免费Base 上的 1 USDC

付款前，结账页面会提供完整示例报告、Base MCP 购买指南和支持信息，然后在服务端验证 Base USDC 交易。结账页面和成功后续页面都会自动重试待处理回执，然后才解锁私有套餐。已提交的交易哈希会保留在当前 URL 中，因此刷新页面后会继续验证，而不会丢失解锁流程。

公开套餐证明会在付款前展示准确的命令行报告格式和文件清单。规范测试会将示例与当前策略引擎进行比对，并验证每个宣传的文件是否存在于付费 tarball 中：

安装免费评估器技能

安装一个不会执行操作的预检工作流，用于公开、非敏感的操作清单：

npx skills add https://github.com/fxjim/agent-commerce-guard --skill try-agent-commerce-guard

此技能会强制遵守托管数据边界，通过免费端点评估最多 5 个操作和 20 KB，并将私有工作流交由付费本地套餐处理，不会发起付款。

GitHub Copilot 插件

直接从 GitHub 安装仅用于策略审查的插件：

copilot plugin install fxjim/agent-commerce-guard:plugins/agent-commerce-guard

此插件的技能使用 /api/policy-review，仅返回决策和所需证据，不包含结账或付款链接。其不可变的 1.0.0 源码已标记为 copilot-plugin-v1.0.0。 官方的 Awesome Copilot 审查 已通过自动化质量关卡，现可供审查。

远程 MCP 服务

将 MCP 客户端连接到公开的无状态 Streamable HTTP 端点：

https://agent-commerce-guard.vercel.app/api/mcp

Codex：

codex mcp add agent-commerce-guard --url https://agent-commerce-guard.vercel.app/api/mcp

Claude Code：

claude mcp add --transport http agent-commerce-guard https://agent-commerce-guard.vercel.app/api/mcp

VS Code mcp.json：

{
  "servers": {
    "agent-commerce-guard": {
      "type": "http",
      "url": "https://agent-commerce-guard.vercel.app/api/mcp"
    }
  }
}

设置和验证：Vercel 指南 或 GitHub Pages 镜像。

该服务提供一个只读、非破坏性的工具 review_agent_commerce_actions。它最多接受 5 个非敏感公开操作和 20 KB 数据，返回判定结果和所需证据；不会执行、付款、签名、部署、发帖，也不会在工具输出中包含购买说明。MCP 1.2.0 还提供一个公开 JSON 资源 https://agent-commerce-guard.vercel.app/offer.json，让客户端能够查明确切的 1 USDC Base 报价，而不会将购买数据混入策略工具结果中。服务初始化时会向客户端提供该资源的指引，要求付款前获得明确批准，并要求付款后验证 Base 交易。review-before-purchase 提示词将策略审查、报价查看、明确批准和收据验证串联起来，但不会发起付款。注册表元数据见 server.json。 官方 Registry 将 io.github.fxjim/agent-commerce-guard 列为活跃的远程服务。

安装买家 Skill

为 Codex、Claude Code、Cursor 和其他兼容 Agent Skills 的助手安装免费的公开买家工作流：

npx skills add https://github.com/fxjim/agent-commerce-guard --skill buy-agent-commerce-guard

同一 Skill 也可从规范产品域名获取：

npx skills add https://agent-commerce-guard.vercel.app --skill buy-agent-commerce-guard

该 Skill 会预先检查公开报价，并要求在进行任何 Base Account、Base MCP、x402、浏览器钱包或手动付款前获得明确批准。其源代码见 skills/buy-agent-commerce-guard/SKILL.md。 其已编入索引的目录页面可在 skills.sh 上查看。 只有在验证了 1 USDC 付款后，才能获取付费产品包。

GitHub Action

在 ubuntu-latest 工作流中运行免费的托管策略预检：

- uses: fxjim/agent-commerce-guard@v1
  with:
    manifest: agent-commerce-actions.json
    fail-on: deny

清单可以是单个操作、操作数组，或包含 actions 数组的对象。该 Action 最多向公开托管评估器发送 5 个操作和 20 KB 数据，打印经过净化的判定结果，并可在操作遭拒或需要审核时使流程失败。它会在发出请求前拒绝包含明显机密的 JSON 键。

该 Action 提供用于私有本地包的 checkout-url、用于付费工作流 API 的 x402-evaluate-url、用于完整 CLI 示例的 sample-report-url、用于机器可读清单的 package-metadata-url，以及用于已授权 Base MCP 助手的 base-mcp-recipe-url。每次评估完成后，作业摘要都会链接到验证和购买路径。

请勿提交机密、私有源代码、凭据或敏感客户数据。如果操作清单不能离开运行器，请使用付费本地包。完整工作流和无害示例清单见 examples/github-actions/。

Launch Pass

Launch Pass 可在 Base 上以 1 USDC 购买。

包含内容

  • CLI 策略引擎。
  • 适用于 Codex、Claude 和 OpenClaw 风格工作流的 Agent 技能包。
  • 审批日志和启动检查清单模板。
  • 操作清单示例。
  • 本地 HTTP 评估器。
  • 由 Vercel 控制的下载流程。
  • 托管演示端点，返回经过清理的决策，不会回显提交的操作文本。
  • 一键托管演示预设，涵盖钱包支出、生产部署、代币发行和市场任务。
  • 面向非敏感操作清单的免费评估器技能，明确提供本地包交接方式。
  • 免费 GitHub Action，用于 CI 策略预检，支持拒绝本地密钥并配置失败行为。
  • 演示响应包含付费购买元数据和准确的 x402 后续操作命令。
  • 面向编码 Agent、OpenAPI、x402 和大模型发现的 Agent／插件清单。
  • 面向 x402 Agent 和 Base 手动购买者的复制粘贴式购买指南。
  • 机器可读的 Base USDC 付款请求，包含 EIP-681 转账 URI。
  • 机器可读的付款元数据会将 /verify?tx={tx} 和 /success?tx={tx} 均列为付款后的解锁页面。
  • 特定产品的 Base MCP 购买步骤，明确列出链、代币、接收方、金额和审批限制。
  • 可免费安装的买家技能，包含预检、审批、验证和解锁步骤。
  • 用于移动钱包付款的扫码支付 SVG 二维码。
  • 首页买家命令区域，提供准确的 x402 查看／支付命令和复制按钮。
  • 已接入 OG／Twitter／schema 元数据的社交预览图片。
  • 在线首页包含结构化的 Product／SoftwareApplication 元数据，便于搜索和爬虫发现。
  • IndexNow 密钥路由和已更新的提交 URL 批次，加快搜索发现。
  • 已置顶的 GitHub 发布／支持议题，供买家提问并查看 x402 集成说明。
  • 公开的 GitHub 发布讨论，介绍产品背景并帮助买家发现产品。
  • 用于搜索和买家发现的 GitHub Pages 发布页面。
  • 公开的 GitHub Gist 买家简介，包含准确的 Base／x402 购买命令。
  • GitHub Pages 上面向 Agent 的可读镜像，包含 llms.txt、agents.json、agent.json、offer.json、.well-known/agent-commerce-guard.json、.well-known/offer.json、openapi.json、.well-known/openapi.json、.well-known/ai-plugin.json、package-metadata.json、.well-known/package-metadata.json、status.json、.well-known/status.json、.well-known/x402、.well-known/agents.json、.well-known/agent.json、.well-known/purchase.json、pay/、robots.txt 和 sitemap.xml。
  • 用于付费和演示端点的 OpenAPI 3.1 规范。
  • 支持 Agent 原生购买的 x402 付费包端点，运行于 Base 主网。
  • 支持 Agent 原生策略决策的 x402 付费评估端点，评估通过 POST 提交的操作清单。
  • 用于 Agent 工作流验证、命令风险评分、破坏性操作审查和钱包支出审批的发现元数据。
  • x402 Bazaar 元数据标签：agent-commerce、agent-safety、guardrails、approval-gates、codex、x402。

存在意义

Agent 商业的发展速度超过了 Agent 治理。此工具会拦截或升级处理跨越财务、生产、社交、代币或凭据边界的操作，直到有明确的证据和审批为止。

Agent 买家流程

  1. 阅读 https://agent-commerce-guard.vercel.app/offer.json。
  2. 打开 https://agent-commerce-guard.vercel.app/pay，使用官方 Base Account 控件查看并确认 Base 主网上的 1 USDC。
  3. 或在获得授权的 Base MCP 助手中加载 https://agent-commerce-guard.vercel.app/base-mcp.json，阅读 https://agent-commerce-guard.vercel.app/pay.json 获取准确的 Base 手动付款请求，或扫描 https://agent-commerce-guard.vercel.app/qr。
  4. 在 /verify?tx={tx}、/success?tx={tx} 或 /api/base-payment-status?tx={tx} 验证交易。两个浏览器页面都会自动重试待处理的 Base 收据，并在刷新后从 URL 恢复。
  5. 从 /success?tx={tx} 或 /api/base-download?tx={tx} 下载软件包。

Agent 买家也可以直接调用 https://agent-commerce-guard.vercel.app/api/x402-download，并满足返回的 x402 付款要求。

Agent 工作流可以调用 POST https://agent-commerce-guard.vercel.app/api/x402-evaluate，并满足返回的 x402 付款要求，以获取经过净化的策略决策。

x402 端点会返回 Base 主网上针对 1000000 个 USDC 原子单位的 exact 付款要求，并包含用于 Agent 发现的路由级 Bazaar 元数据。

购买问题、钱包流程问题和 x402 集成说明可以发布到置顶的发布/支持议题：https://github.com/fxjim/agent-commerce-guard/issues/1。

发布背景和买家发现讨论串：https://github.com/fxjim/agent-commerce-guard/discussions/2。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。