用途:通过已配置的 cardano MCP 服务器只读查询钱包状态,包括余额、地址和 UTxO。适用于用户询问钱包余额、ADA 持仓、原生代币数量、钱包地址,或想查看未花费输出(UTxO)时。不签名、不提交交易。
主要能力:提供三个 MCP 工具。get_balances 返回连接钱包的全部代币余额,输出 { balances: [{ name, policyId, nameHex, amount }] },ADA 的 name 为 "ADA"、policyId 与 nameHex 为空字符串,原生资产为解码后的名称与 56 位十六进制 policyId;amount 对 ADA 为 lovelace,对原生资产为原始数量。get_addresses 返回去重的 bech32 地址数组。get_utxos 返回每个以 CBOR 十六进制序列化的 UTxO 字符串数组。
使用方式:先检测 MCP 是否可用,若 get_balances、get_addresses 或 get_utxos 工具不可用,则回退到 Koios 或 CLI 技能,不应因缺少 MCP 而报错。展示 ADA 时须将 lovelace 除以 1,000,000。绝不索要助记词或私钥,密钥材料由 MCP 服务器内部管理。
适用场景与限制:当前集成默认主网,除非已针对所配置的 MCP 服务器明确验证测试网支持。需要构建或提交交易时应改用 cardano-mcp-transactions 或 builder 技能。未配置 cardano MCP 服务器时,回退到 koios-agent-wallet 或 cardano-cli-wallets。钱包状态查询优先级为:cardano MCP(若已配置)、koios-agent-wallet(MeshJS + Koios,任意网络)、cardano-cli-wallets(CLI,任意网络)。MCP 可用时只读钱包状态优先走 MCP;不可用或需要测试网时直接回退,无需提示。cardano-mcp 项目地址:https://github.com/IndigoProtocol/cardano-mcp。