Cardano Mcp

Name: Cardano Mcp
Author: IndigoProtocol

本地服务

github.com/IndigoProtocol金融数据426 周前更新

代码仓库

关于 Cardano Mcp

Cardano MCP 服务为 AI Agent 和自动化系统提供链上钱包与网络查询、质押信息及交易提交能力。支持查询地址、UTxO、ADA 与原生代币余额、ADAHandles 和奖励，并在本地签署交易。

主要功能

01提交已签名的 Cardano 交易
02查询地址与 UTxO
03获取 ADA 和代币余额
04解析 ADAHandles
05查看质押委托与可领取奖励
06本地签名，助记词不暴露给 LLM

适用场景

01查询钱包余额与持有的代币
02提交交易并获取交易哈希
03检查质押池与可领取奖励
04查看钱包持有的 ADAHandles

MCP 相关

该 MCP 服务向 MCP 客户端提供 Cardano 钱包工具，包括交易提交、地址与 UTxO 查询、余额、ADAHandles 和质押信息。

#cardano #blockchain #defi #finance #crypto

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cardano": {
      "command": "npx",
      "args": [
        "-y",
        "@indigoprotocol/cardano-mcp"
      ]
    }
  }
}

启动命令npx -y @indigoprotocol/cardano-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@indigoprotocol/cardano-mcp1.0.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Cardano MCP 服务

通过 Model Context Protocol，供 AI Agent 和自动化系统与 Cardano 区块链交互的 MCP 服务。

这是 Indigo AI Stack 的一部分——搭配 Indigo MCP 使用，可获得完整的 Cardano DeFi 功能。

⚡ 只需 2 条命令即可开始

# Install
npm install -g @indigoprotocol/cardano-mcp

# Setup (interactive)
npx @indigoprotocol/cardano-mcp setup

╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║    ██████╗ █████╗ ██████╗ ██████╗  █████╗ ███╗   ██╗ ██████╗  ║
║   ██╔════╝██╔══██╗██╔══██╗██╔══██╗██╔══██╗████╗  ██║██╔═══██╗ ║
║   ██║     ███████║██████╔╝██║  ██║███████║██╔██╗ ██║██║   ██║ ║
║   ██║     ██╔══██║██╔══██╗██║  ██║██╔══██║██║╚██╗██║██║   ██║ ║
║   ╚██████╗██║  ██║██║  ██║██████╔╝██║  ██║██║ ╚████║╚██████╔╝ ║
║    ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝  ║
║                                                               ║
║   ███╗   ███╗ ██████╗██████╗                                  ║
║   ████╗ ████║██╔════╝██╔══██╗                                 ║
║   ██╔████╔██║██║     ██████╔╝                                 ║
║   ██║╚██╔╝██║██║     ██╔═══╝                                  ║
║   ██║ ╚═╝ ██║╚██████╗██║                                      ║
║   ╚═╝     ╚═╝ ╚═════╝╚═╝                                      ║
║                                                               ║
║   6 wallet tools for Cardano                                  ║
║                                                               ║
╚═══════════════════════════════════════════════════════════════╝

就是这么简单——为 Claude Desktop、Claude Code、Cursor 或 Windsurf 配置 6 个钱包工具。

功能

向 Cardano 网络提交已签名的交易
获取钱包地址和 UTxO
获取代币余额（ADA + 原生代币）
解析 ADAHandles（handle.me）
查看质押委托和可领取奖励
由 Lucid Evolution 提供支持的感知钱包工具

快速开始

自动设置（推荐）

运行交互式设置，自动配置 MCP 客户端：

npx @indigoprotocol/cardano-mcp setup

设置过程将：

询问你使用的客户端（Claude Desktop、Claude Code、Cursor、Windsurf）
提示输入 Blockfrost Project ID
提示输入钱包助记词（存储在本地，不会暴露给大模型）
自动更新配置文件

手动安装

全局安装：

npm install -g @indigoprotocol/cardano-mcp

或使用 npx 直接运行：

npx @indigoprotocol/cardano-mcp

Docker

docker build -t cardano-mcp .
docker run -p 8000:8000 \
  -e PORT=8000 \
  -e SEED_PHRASE="your seed phrase here" \
  -e BLOCKFROST_PROJECT_ID="your_blockfrost_key" \
  cardano-mcp

配置

环境变量

变量	必需	说明
`SEED_PHRASE`	是	钱包助记词（以逗号分隔）。不会暴露给大模型。
`BLOCKFROST_PROJECT_ID`	是*	从 blockfrost.io 获取的 Blockfrost API 密钥
`KUPO_URL`	可选	Kupo 端点 URL（Blockfrost 的替代方案）
`OGMIOS_URL`	可选	Ogmios 端点 URL（Blockfrost 的替代方案）
`PORT`	否	HTTP 服务端口（默认值：8000）

*必须设置 BLOCKFROST_PROJECT_ID，或同时设置 KUPO_URL 和 OGMIOS_URL。

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "cardano": {
      "command": "npx",
      "args": ["-y", "@indigoprotocol/cardano-mcp"],
      "env": {
        "SEED_PHRASE": "word1,word2,word3,...",
        "BLOCKFROST_PROJECT_ID": "mainnetXXXXXXXXXXXXXXX"
      }
    }
  }
}

Claude Code（CLI）

添加到 ~/.claude/settings.json，或项目中的 .claude/settings.json：

{
  "mcpServers": {
    "cardano": {
      "command": "npx",
      "args": ["-y", "@indigoprotocol/cardano-mcp"],
      "env": {
        "SEED_PHRASE": "word1,word2,word3,...",
        "BLOCKFROST_PROJECT_ID": "mainnetXXXXXXXXXXXXXXX"
      }
    }
  }
}

Cursor

添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目级）：

{
  "mcpServers": {
    "cardano": {
      "command": "npx",
      "args": ["-y", "@indigoprotocol/cardano-mcp"],
      "env": {
        "SEED_PHRASE": "word1,word2,word3,...",
        "BLOCKFROST_PROJECT_ID": "mainnetXXXXXXXXXXXXXXX"
      }
    }
  }
}

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "cardano": {
      "command": "npx",
      "args": ["-y", "@indigoprotocol/cardano-mcp"],
      "env": {
        "SEED_PHRASE": "word1,word2,word3,...",
        "BLOCKFROST_PROJECT_ID": "mainnetXXXXXXXXXXXXXXX"
      }
    }
  }
}

OpenClaw

为 OpenClaw 安装 Cardano 技能：

openclaw skills add IndigoProtocol/cardano-skills

技能会自动配置——立即开始使用 Cardano 钱包工具。

与 Indigo MCP 搭配使用

要获得完整的 Cardano DeFi 功能，请同时使用 Cardano MCP 和 Indigo MCP：

{
  "mcpServers": {
    "indigo": {
      "command": "npx",
      "args": ["-y", "@indigoprotocol/indigo-mcp"],
      "env": {
        "BLOCKFROST_API_KEY": "your-blockfrost-project-id"
      }
    },
    "cardano": {
      "command": "npx",
      "args": ["-y", "@indigoprotocol/cardano-mcp"],
      "env": {
        "SEED_PHRASE": "word1,word2,word3,...",
        "BLOCKFROST_PROJECT_ID": "your-blockfrost-project-id"
      }
    }
  }
}

可用工具

交易工具

工具	说明	参数
`submit_transaction`	使用已连接的钱包签名并提交 Cardano 交易	`cbor`：未签名交易的 CBOR 十六进制字符串

输出： { transactionHash: string, timestamp: number }

地址工具

工具	说明	参数
`get_addresses`	获取已连接钱包的所有 Cardano 地址	无

输出： { addresses: string[] }

UTxO 工具

工具	说明	参数
`get_utxos`	以原始 CBOR 格式获取已连接钱包的所有 UTxO	无

输出： { utxos: string[] }（CBOR 十六进制编码）

余额工具

工具	说明	参数
`get_balances`	获取已连接钱包的所有代币余额	无

输出：

{
  "balances": [
    {
      "name": "ADA",
      "policyId": "",
      "nameHex": "",
      "amount": 1500000000
    },
    {
      "name": "INDY",
      "policyId": "533bb94...",
      "nameHex": "494e4459",
      "amount": 100000000
    }
  ]
}

ADAHandle 工具

工具	描述	参数
`get_adahandles`	检索已连接钱包拥有的所有 ADAHandle（handle.me）	无

输出： { adaHandles: string[] }（例如，["$myhandle", "$another"]）

质押工具

工具	描述	参数
`get_stake_delegation`	检索质押池委托信息和可用的 ADA 奖励	无

输出：

{
  "poolId": "pool1...",
  "availableAdaRewards": 12.5
}

使用示例

查看钱包余额

"What's my ADA balance?"

Claude 将使用 get_balances，并显示你的 ADA 和代币持有情况。

提交交易

"Submit this transaction: 84a400..."

Claude 将使用 submit_transaction 对 CBOR 交易进行签名并提交，然后返回交易哈希。

查看质押奖励

"How much staking rewards do I have available?"

Claude 将使用 get_stake_delegation 显示你的质押池和可领取奖励。

解析 ADAHandle

"What ADAHandles do I own?"

Claude 将使用 get_adahandles 列出你的所有 handle.me Handle。

故障排除

nvm 用户（macOS/Linux）

如果你使用 nvm，且 Claude Desktop 显示“server disconnected”，则需要使用完整路径，因为 Claude Desktop 不会继承 Shell 中的 nvm 配置：

{
  "mcpServers": {
    "cardano": {
      "command": "/Users/YOU/.nvm/versions/node/v22.x.x/bin/npx",
      "args": ["-y", "@indigoprotocol/cardano-mcp"],
      "env": {
        "PATH": "/Users/YOU/.nvm/versions/node/v22.x.x/bin:/usr/local/bin:/usr/bin:/bin",
        "SEED_PHRASE": "word1,word2,...",
        "BLOCKFROST_PROJECT_ID": "mainnetXXX"
      }
    }
  }
}

使用以下命令查找 Node 路径：which npx

缓存问题

如果更新后工具无法运行，请清除 npm 缓存：

rm -rf ~/.npm/_npx

然后重启 Claude Desktop。

平台支持

平台	状态	备注
macOS	✅ 完全支持	Intel 和 Apple Silicon
Windows	✅ 完全支持	Windows 10/11
Linux	✅ 完全支持	x64 和 ARM64

安全

⚠️ 重要： 你的助记词存储在本地，仅用于钱包操作。它绝不会暴露给大模型或外部服务。

助记词仅由本地 Lucid Evolution 钱包实例使用
所有交易均在本地签名后再提交
绝不会传输私钥

免责声明

使用此 Cardano MCP 服务及所有相关工具和技术（“MCP”），即表示你确认并同意：

你使用去中心化金融（包括 MCP 和/或你授权其管理数字资产的 AI Agent）会面临多种重大财务风险
这些风险包括但不限于：由 MCP 设计或指令造成的财务损失风险、无常损失以及数字资产价格变动
你对所有 MCP 操作和交易负全部责任
你对助记词、私钥和环境配置的安全负全部责任

许可证

MIT

支持 Markdown

登录后评论

基本信息

作者: IndigoProtocol
语言: node
版本: 1.0.2
传输方式: stdio
收录时间: 2026年3月8日
最近更新: 26 周前
官方 Registry: io.github.IndigoProtocol/cardano-mcp

报告问题

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。