在 goose 中接入 Spraay x402 MCP Server：用链上 USDC 微支付解锁批量转账与 200+ AI 模型调用
在 goose 中接入 Spraay x402 MCP Server用链上 USDC 微支付解锁批量转账与 200 AI 模型调用【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goose本指南讲解如何将 Spraay x402 MCP Server 作为 goose 的自定义扩展Extension接入使 goose Agent 获得基于 Base 链的批量加密支付单笔交易最多 200 个收款地址、实时链上行情查询、钱包余额查询、ENS 解析、Uniswap V3 兑换报价以及 200 AI 模型的按次付费对话能力。读完本文你将掌握从安装构建 MCP 服务器、在 goose Desktop 与 goose CLI 中完成扩展配置到理解 x402先返回 HTTP 402、再自动签名支付这一支付流程的完整实战方案。为什么用 Spraay 扩展x402 协议下的按次付费传统的 AI Agent 扩展通常需要注册账号、申请 API Key、维护月度订阅额度。Spraay 走的是另一条路线它基于 x402 协议HTTP 402 Payment Required 语义的支付扩展由 AI Agent 在每次工具调用时直接以 USDC 在 Base 链上完成微支付——按次计费、无需 API Key、无需注册账号只要钱包里有 Base 链上的 USDC 即可。接入后goose 获得的典型能力包括批量支付单笔交易向最多 200 个收款地址发送 ETH 或 ERC-20 代币如批量分发 USDC链上数据实时查询代币价格Uniswap V3 喂价、任意地址的 ETH/ERC-20 余额、解析 ENS 与 BasenameAI 模型接入经由spraay_chat调用 200 模型如 GPT-4、Claude、Llama、Gemini按请求付费。对 goose 而言这类功能以命令型stdioMCP 扩展的形式注册——goose 通过标准输入输出与该 MCP Server 进程通信把工具暴露给 Agent 编排调用。goose 自身的扩展配置模型对这类扩展提供了完整支持下文会在源码视角部分说明其落地机制。Spraay 提供的工具集ToolsSpraay x402 MCP Server 对外暴露以下 9 个工具每次调用费用以 USDC 结算Tool单次费用功能说明spraay_chat$0.005AI 对话可路由到 200 模型GPT-4、Claude、Llama、Geminispraay_models$0.001列出可用 AI 模型及对应定价spraay_batch_execute$0.01向多个收款地址批量发送 USDCspraay_batch_estimate$0.001估算批量支付所需 Gas 费用spraay_swap_quote$0.002获取 Base 链 Uniswap V3 兑换报价spraay_tokens$0.001列出 Base 链上受支持的代币spraay_prices$0.002实时链上代币价格Uniswap V3spraay_balances$0.002查询任意地址的 ETH ERC-20 余额spraay_resolve$0.001将 ENS 域名与 Basename 解析为地址需要注意这里的费用是AI Agent 通过 x402 协议按请求支付 USDC而非传统 API 订阅。整个调用链路不需要 API Key 或账号——只需要一个在 Base 上持有 USDC 的钱包。前置条件与 MCP Server 安装接入前需要准备已安装 Git 与 Node.js一个持有 Base 链 USDC 的钱包私钥用于 x402 微支付。先在本地安装并构建 Spraay x402 MCP Servergit clone https://github.com/plagtech/spraay-x402-mcp.git cd spraay-x402-mcp npm install npm run build构建产物为dist/index.js。goose 启动扩展时会直接以子进程方式运行该文件因此请记录下该文件的绝对路径后续配置命令时需要用到路径形式如/absolute/path/to/spraay-x402-mcp/dist/index.js。将 Spraay 注册为 goose 扩展goose 支持通过 Desktop 图形界面与 CLI 两种方式添加自定义扩展二者都会写入同一份扩展配置选择其一即可。方式一goose Desktop点击侧边栏的Extensions扩展图标点击Add custom extension添加自定义扩展选择Command-line Extension命令行扩展填写以下字段Name名称spraayCommand命令node /absolute/path/to/spraay-x402-mcp/dist/index.jsTimeout超时秒300添加环境变量Name变量名EVM_PRIVATE_KEYValue变量值你的钱包私钥需持有 Base 链 USDC方式二goose CLI在终端运行goose configure选择Add Extension→Command-line Extension随后按交互提示依次填写填写过程与 Desktop 界面完全等价┌ goose-configure │ │ ◇ What would you like to call this extension? │ spraay │ │ ◇ What command should be run? │ node /absolute/path/to/spraay-x402-mcp/dist/index.js │ │ ◇ Please set the timeout for this tool (in secs): │ 300 │ │ ◇ Would you like to add environment variables? │ Yes │ │ ◇ Environment variable name: │ EVM_PRIVATE_KEY │ │ ◇ Environment variable value: │ ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪ │ │ └ Added spraay extension配置完成后 goose 即会建立与 Spraay MCP Server 的 stdio 连接并在会话中列出上述 9 个工具供 Agent 选择调用。源码视角命令行扩展在 goose 中是如何落地的Spraay 属于典型的stdio 类型 MCP 扩展。goose 对扩展配置的建模可在 crates/goose/src/agents/extension.rs 的ExtensionConfig枚举中找到对应定义Stdio变体包含name、cmd、args、envs、env_keys、timeout、cwd等字段。你在配置界面填写的命令、超时、环境变量最终都会被序列化进配置文件默认位于~/.config/goose/config.yaml的extensions段运行时再被解析还原为该枚举值。以下几点从源码结构看值得留意命令与参数分离cmd是命令本体这里是node而脚本路径实际上会被当作args中的一个参数传入配置解析相关实现。这意味着任何安装路径调整都只需修改参数部分无需改动命令本身。超时默认值即 300 秒配置界面推荐填写的300并非偶然。goose 源码中DEFAULT_EXTENSION_TIMEOUT常量即定义为 300见 crates/goose/src/config/extensions.rs当某个扩展未显式设置超时时运行时由resolve_timeout回落到该默认值见 crates/goose/src/agents/extension_manager.rs。goose 会基于该超时限制每次工具调用的等待时长因此对于涉及区块确认、可能耗时较长的支付类工具保持 300 秒是合理选择。名称会被规范化为配置 key扩展名spraay会经name_to_key处理小写化并规范化非字母数字字符以作为extensions映射的键见 crates/goose/src/config/extensions.rs。敏感信息注入EVM_PRIVATE_KEY这类私钥通过环境变量注入子进程而不是写死在命令参数里——命令行ps可见中不会暴露私钥明文。goose 的Stdio配置同样支持env_keys机制可将秘钥存于系统 keyring 或密钥文件后再解析注入避免在配置文件与日志中留下明文痕迹。实际使用示例扩展注册成功后直接以自然语言向 goose 下达指令即可。goose 会自主判断并调用对应的 Spraay 工具完成链路。查询代币价格Whats the current price of ETH on Base?goose 将调用spraay_prices从 Uniswap V3 拉取 ETH 的实时链上价格。查询钱包余额含 ENS 解析Check the USDC balance of vitalik.ethgoose 会先调用spraay_resolve将 ENS 名解析为地址再调用spraay_balances查询该地址的 USDC 余额——这展示了 goose 对多工具的链式编排能力。获取兑换报价Get me a swap quote for 100 USDC to WETH on Basegoose 将调用spraay_swap_quote从 Uniswap V3 获取 100 USDC → WETH 的实时兑换报价。批量发送 USDCSend 10 USDC each to these wallets: 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18 0x53d284357ec70cE289D6D64134DfAc8E511c8a3D 0xFBb1b73C4f0BDa4f67dcA266ce6Ef42f520fBB98goose 将调用spraay_batch_execute在单笔链上交易内完成对全部地址的批量支付——这正是该扩展的核心价值场景如批量打款、社区激励分发。执行前建议先用spraay_batch_estimate估算 Gas避免因费用估算偏差导致交易失败。让 Agent 调用其他 AI 模型Using spraay, ask GPT-4 to explain what x402 isgoose 将调用spraay_chat从 200 可用模型中选择目标模型完成对话请求。工作原理x402 支付即调用一次 Spraay 工具调用的完整链路如下你向 goose 发出指令goose 调用某个 Spraay 工具如spraay_pricesgoose 将 MCP 请求发送至 Spraay 网关gateway.spraay.app网关返回HTTP 402响应并附上支付要求金额、收款方、代币等元数据客户端侧的 x402 实现自动在 Base 链上签署一笔 USDC 支付网关验证链上支付到账后返回本次请求所需的真实数据。从用户体验看整个请求 → 计费 → 放行的过程对 goose 是透明的每次调用消耗约 $0.001–$0.01 的 USDC没有订阅费、没有 API Key、无需注册账号。支付发生在 Base 链上因此单笔金额小、确认快天然适配 Agent 高频工具调用场景。安全与成本提示EVM_PRIVATE_KEY是可直接支配钱包资产的私钥务必妥善保管不要将其写入会被共享的配置文件、提交到 Git 仓库或暴露在聊天记录中。优先使用 goose Desktop 的环境变量设置其写入受控的配置与密钥存储路径。每次工具调用都会真实消耗 USDC成本随使用量线性累加。建议钱包中仅存放计划用于微支付的少量 USDC避免大额资产暴露在 Agent 调用链路中。涉及转账与支付的指令务必核对收款地址与金额spraay_batch_execute一旦在链上确认即不可撤回。延伸资源围绕该扩展可进一步了解的资料包括Spraay App多链批量支付应用据其文档覆盖约 10 条链Spraay x402 GatewayAI Agent 支付网关即上述工作流中的服务端x402 Protocol定义 HTTP 402 语义的支付协议标准链上合约可在 BaseScan 上核查 Spraay 相关智能合约示例地址0x1646452F98E36A3c9Cfc3eDD8868221E207B5eEC以确认支付去向与合约逻辑。若想进一步理解 goose 扩展系统的配置解析细节可继续阅读 crates/goose/src/config/extensions.rs 与 crates/goose/src/agents/extension.rs 两个源文件它们完整刻画了命令行扩展从 YAML 配置到运行时客户端建立的整个过程。【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goose创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考