用途
Cardano MCP Server 用于让 AI 智能体和自动化系统通过 Model Context Protocol（MCP）与 Cardano 区块链进行钱包层面的交互。它是 Indigo AI Stack 的一部分，官方说明可与 Indigo MCP 搭配使用，以获得完整的 Cardano DeFi 能力。
主要能力
服务器配置了 6 个钱包工具，可支持以下操作：
- 向 Cardano 网络提交已签名交易（输出包含 transactionHash 与 timestamp）
- 获取钱包地址（输出 addresses 字符串数组）
- 读取 UTxO（输出 utxos 字符串数组，CBOR hex 编码）
- 查询代币余额（ADA 及原生代币）
- 解析 ADAHandles（handle.me），例如返回 ["$myhandle", "$another"]
- 检查质押委托与可领取奖励
官方说明这些钱包感知工具由 Lucid Evolution 驱动。
使用方式
官方提供自动设置与手动安装两种方式。
自动设置（推荐）
运行交互式设置以自动配置 MCP 客户端，流程包括：询问所使用的客户端（Claude Desktop、Claude Code、Cursor、Windsurf）、提示输入 Blockfrost Project ID、提示输入钱包助记词（本地存储，不会暴露给 LLM）、自动更新配置文件。官方称仅需 2 条命令即可开始，即可为上述客户端配置好 6 个钱包工具。
手动安装
可全局安装，或直接使用 npx 运行。
环境变量
必须提供 BLOCKFROST_PROJECT_ID，或同时提供 KUPO_URL + OGMIOS_URL。
各客户端配置位置
- Claude Desktop：macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 为 %APPDATA%\Claude\claude_desktop_config.json
- Claude Code（CLI）：~/.claude/settings.json 或项目内的 .claude/settings.json
- Cursor：全局 ~/.cursor/mcp.json 或项目级 .cursor/mcp.json
- Windsurf：~/.codeium/windsurf/mcp_config.json
此外可为 OpenClaw 安装 Cardano skills，官方说明 skills 会自动配置，安装后即可立即使用 Cardano 钱包工具。
与 Indigo MCP 搭配
官方建议同时使用 Cardano MCP 与 Indigo MCP，以获得完整的 Cardano DeFi 能力。
典型调用示例（官方提供）
- 查询钱包余额：Claude 会使用 get_balances 并返回 ADA 与代币持有情况
- 提交交易：Claude 会使用 submit_transaction 签名并提交 CBOR 交易，返回交易哈希
- 查询质押奖励：Claude 会使用 get_stake_delegation 显示已质押池与可领取奖励
- 解析 ADAHandles：Claude 会使用 get_adahandles 列出所有 handle.me 句柄
适用场景
适合需要让 AI 智能体或自动化系统执行 Cardano 钱包操作的场景，例如查询余额与 UTxO、解析 ADAHandles、检查质押委托与奖励，以及提交已签名交易；也可与 Indigo MCP 组合用于 Cardano DeFi 相关工作流。
安全与限制
官方说明：助记词仅存储在本地，只用于钱包操作，不会暴露给 LLM 或外部服务；助记词仅由本地 Lucid Evolution 钱包实例使用；所有交易签名在提交前于本地完成；私钥不会被传输。
官方还给出故障排查提示：使用 nvm 的用户（macOS/Linux）若 Claude Desktop 显示「server disconnected」，需使用完整路径，因为 Claude Desktop 不会继承 shell 的 nvm 设置，可用 which npx 查找 node 路径；若更新后工具失败，可清除 npm 缓存后重启 Claude Desktop。
官方风险声明：使用该 MCP 及相关工具与技术，即表示你确认并同意：使用去中心化金融（包括 MCP 及你授权管理数字资产的 AI 智能体）涉及多种重大财务风险，包括但不限于 MCP 设计或指令导致的财务损失、无常损失以及数字资产价格变动；你对所有 MCP 操作与交易负全部责任；你对自己的助记词、私钥与环境配置的安全负全部责任。
平台支持等其余细节暂未提供。
