SuperAPI AI 工具集

mcp-wallet

智能体与模型

查看项目

更新于 10-15 20:10

技能介绍

用途:让 AI 智能体作为 Nano(XNO)钱包操作者,通过 xno-mcp 提供的 MCP 工具直接创建钱包、列出钱包、查询余额、发送与接收 XNO,并进行支付请求管理。密钥托管在 xno-mcp 内,创建钱包只返回地址。

主要能力:wallet_create 创建或导入命名钱包(支持 bip39 格式,可用助记词导入);wallet_list 列出钱包;wallet_balance 与 wallet_probe_balances 查看余额及账户是否已开启;wallet_receive 收款并开启账户;wallet_send 发款;wallet_history 记录发送、接收、对手方地址、金额、哈希及关联支付请求。支付请求相关工具有 payment_request_create、payment_request_status、payment_request_receive、payment_request_refund。也可通过 MCP Resource URI(wallet://{name} 与 wallet://{name}/account/{index})被动读取状态。

使用方式:先调用 config_set 设置 RPC URL 与默认代表,例如 { "rpcUrl": "https://rpc.nano.org", "defaultRepresentative": "nano_..." },也可设置 useLocalPow、workUrl、maxSendXno。Nano 转账在发布接收块前处于 pending 状态,收到资金后必须主动调用 wallet_receive 才能入账并开启账户;未开启账户首次接收需要代表,可用 defaultRepresentative 或显式传参。发送前账户需已开启并有足够余额,wallet_send 会在余额不足但存在 pending 时自动先接收。

适用场景:需要让智能体以自然语言管理 Nano 钱包、查询余额、收发小额 XNO、处理结构化收款与退款的场景。

限制:每次 wallet_send 与 payment_request_refund 有单笔发送上限,默认 1.0 XNO(由 XNO_MAX_SEND 环境变量设置),可在运行时用 config_set 的 maxSendXno 覆盖。钱包持久化默认开启(可用 XNO_MCP_PERSIST_WALLETS=false 关闭),若开启会以明文 JSON 存储在 .xno-mcp/wallets.json。workUrl 默认等于 rpcUrl。请勿将助记词或种子粘贴到聊天中,密钥由 MCP 托管。其他限制资料未提供。