ZERO Payment Guard

ZERO Payment Guard：服务端

这是托管的 x402 API 和 MCP 服务的源代码：https://zero-payment-guard.worker.beacon.host。 这是一个 Hono 应用，可在兼容 Cloudflare Workers 的运行时和 Node 上运行。

提供的功能

接口	路径	说明
付费 HTTP API（x402 v2，Base 上的 USDC）	GET /v1/*	x402-preflight、usdc-payment、token-check、wallet-snapshot、tx-status、basename、page-extract、page-extract-batch、domain-enrich、company-brief
MCP，可流式传输的 HTTP	POST /mcp	10 个付费工具 + 免费的 sample_report；支付使用 x402-over-MCP（@x402/mcp）
MCP，stdio	npm run stdio	相同的工具，适用于本地客户端和目录检查
免费发现	/openapi.json、/llms.txt、/.well-known/x402、/sample/*

所有处理程序均为只读：读取公开的 Base RPC、公开的 DNS/RDAP，以及按请求抓取公开网页（遵守 robots.txt 并屏蔽私有主机）。服务端不持有私钥。它只指定接收付款的 PAY_TO 地址，结算由 facilitator 完成。

本地运行

cd server
npm ci
npm start                 # HTTP on 127.0.0.1:8790 (PORT to change)
npm run stdio             # MCP over stdio

stdio 服务的 MCP 客户端配置：

{
  "mcpServers": {
    "zero-payment-guard": { "command": "npx", "args": ["tsx", "/path/to/zero-payment-guard/server/src/stdio.ts"] }
  }
}

也可以使用 Docker，在仓库根目录运行：docker build -t zero-payment-guard . && docker run -i --rm zero-payment-guard。

配置

在 wrangler.toml 的 [vars] 中设置这些变量，或将其设为环境变量。它们不是机密。

变量	默认值	含义
PAY_TO	operator wallet	接收 USDC 的地址；如果部署副本，请将其改为你自己的地址
NETWORK	eip155:8453	Base 主网
FACILITATOR_URL	https://facilitator.payai.network	x402 facilitator（无需密钥）

可选机密：使用 wrangler secret put 设置，切勿提交：CDP_API_KEY_ID 和 CDP_API_KEY_SECRET 可切换至 Coinbase CDP facilitator。DEV_FREE=1（仅用于本地测试）会禁用付费墙。

部署

运行 npx wrangler deploy（Cloudflare），或部署到任何兼容 Workers 的主机。托管版本运行在 beacon.host 上。

目录结构

• src/index.ts：路由、付费墙（@x402/hono）、发现文档
• src/mcp.ts：MCP 服务（buildMcp）和可流式传输的 HTTP 处理程序
• src/stdio.ts：stdio 入口点；src/node.ts：Node HTTP 入口点
• src/checks*.ts：Base 支付、代币、钱包和交易检查
• src/extract.ts、src/enrich.ts、src/bundle.ts：网页提取和公司信息增强
• src/fac.ts：facilitator 客户端，将 /supported 缓存为数据（可安全用于 Workers）