用途:通过 uxc 以统一方式访问 Dune MCP(https://api.dune.com/mcp/v1),完成区块链数据表检索、SQL 查询创建/执行、执行结果获取与可视化生成。
主要能力:发现类包括 searchDocs、searchTables、listBlockchains、searchTablesByContractAddress;查询生命周期包括 createDuneQuery、getDuneQuery、updateDuneQuery、executeQueryById、getExecutionResults;分析辅助包括 generateVisualization、getTableSize、getUsage。
使用方式:先探测端点与协议,uxc https://api.dune.com/mcp/v1 -h;配置凭据与绑定(示例:uxc auth credential set dune-mcp --auth-type api_key --header "x-dune-api-key={{secret}}" --secret-env DUNE_API_KEY;uxc auth binding add --id dune-mcp --host api.dune.com --path-prefix /mcp/v1 --scheme https --credential dune-mcp --priority 100);建议使用固定命令 dune-mcp-cli,如未创建可执行 uxc link dune-mcp-cli https://api.dune.com/mcp/v1,并用 dune-mcp-cli <operation> -h 查看操作模式。典型流程为先检索表、确认分区日期范围,再创建临时查询、执行并凭执行 ID 取结果。
适用场景:链上数据分析、合约地址相关表定位、按日期聚合的查询与可视化。
限制与注意:需已安装 uxc、可访问上述地址并持有 Dune API key;自动化应使用 JSON 输出,不可依赖 --text;优先解析 ok、kind、protocol、data、error 等字段;创建/更新查询、执行查询、生成可视化等消耗额度或改变状态的操作需用户明确确认;注意 is_private 与 is_temp,临时查询仍可能可见;listBlockchains 报错时可回退到 searchTables 的 blockchains 过滤。