Cardano Mcp

io.github.IndigoProtocol由 GitHub 账号 IndigoProtocol 发布v1.0.2更新于 Oct 24, 2026

Cardano MCP — transactions, addresses, UTxOs, balances, ADAHandles & stake delegation

已验证STDIO仅桌面金融开发者工具

概览

AI 生成的概览

本地 MCP 服务器，让 AI 助手读取 Cardano 钱包的地址、UTxO、余额、ADAHandle 和质押信息，并签名和提交交易。

可以做什么
读取所连接钱包的地址和原始 UTxO，以及 ADA 与原生代币余额和持有的 ADAHandle。查询质押池委托和可领取的 ADA 奖励。对以 CBOR 十六进制提供的未签名 Cardano 交易进行签名并提交，返回交易哈希和时间戳。钱包相关工具运行在本地 Lucid Evolution 钱包实例上。
适用场景
当你希望助手查看 Cardano 钱包或将准备好的交易发送到网络时使用，例如查询余额、ADAHandle 或质押奖励，或提交在别处构建的 CBOR。适合愿意在本地配置中保存助记词的用户。
运行要求
以 npm 包形式通过 stdio 在本地运行，需要 Node.js 和 npx。需要钱包助记词（SEED_PHRASE），以及 BLOCKFROST_PROJECT_ID 中的 Blockfrost 项目 ID，或同时提供 KUPO_URL 和 OGMIOS_URL。需要访问 Cardano 数据提供方的网络；安装程序会写入客户端配置文件。
安装前请注意
服务器需要 SEED_PHRASE 中的钱包助记词，它控制钱包资金，任何能读取该配置的人都能动用资金。submit_transaction 会在 Cardano 网络上签名并广播真实交易，出错可能造成资金损失。README 称助记词不会暴露给大模型且签名在本地完成，但配置和环境仍需自行妥善保管。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Cardano Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Cardano MCP Server

[Smithery] [npm downloads] [Ask DeepWiki]

MCP server for interacting with the Cardano blockchain from AI agents and automation systems via the Model Context Protocol.

Part of the Indigo AI Stack — use alongside Indigo MCP for full Cardano DeFi capabilities.

⚡ 2 Commands to Get Started

bash
# Installnpm install -g @indigoprotocol/cardano-mcp
# Setup (interactive)npx @indigoprotocol/cardano-mcp setup
╔═══════════════════════════════════════════════════════════════╗║                                                               ║║    ██████╗ █████╗ ██████╗ ██████╗  █████╗ ███╗   ██╗ ██████╗  ║║   ██╔════╝██╔══██╗██╔══██╗██╔══██╗██╔══██╗████╗  ██║██╔═══██╗ ║║   ██║     ███████║██████╔╝██║  ██║███████║██╔██╗ ██║██║   ██║ ║║   ██║     ██╔══██║██╔══██╗██║  ██║██╔══██║██║╚██╗██║██║   ██║ ║║   ╚██████╗██║  ██║██║  ██║██████╔╝██║  ██║██║ ╚████║╚██████╔╝ ║║    ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝  ║║                                                               ║║   ███╗   ███╗ ██████╗██████╗                                  ║║   ████╗ ████║██╔════╝██╔══██╗                                 ║║   ██╔████╔██║██║     ██████╔╝                                 ║║   ██║╚██╔╝██║██║     ██╔═══╝                                  ║║   ██║ ╚═╝ ██║╚██████╗██║                                      ║║   ╚═╝     ╚═╝ ╚═════╝╚═╝                                      ║║                                                               ║║   6 wallet tools for Cardano                                  ║║                                                               ║╚═══════════════════════════════════════════════════════════════╝

That's it — 6 wallet tools configured for Claude Desktop, Claude Code, Cursor, or Windsurf.

Features

  • Submit signed transactions to the Cardano network
  • Retrieve wallet addresses and UTxOs
  • Fetch token balances (ADA + native tokens)
  • Resolve ADAHandles (handle.me)
  • Check stake delegation and claimable rewards
  • Wallet-aware tools powered by Lucid Evolution

Quick Start

Automatic Setup (Recommended)

Run the interactive setup to automatically configure your MCP client:

bash
npx @indigoprotocol/cardano-mcp setup

This will:

  1. Ask which client you're using (Claude Desktop, Claude Code, Cursor, Windsurf)
  2. Prompt for your Blockfrost Project ID
  3. Prompt for your wallet seed phrase (stored locally, never exposed to LLMs)
  4. Automatically update your config file

Manual Installation

Install globally:

bash
npm install -g @indigoprotocol/cardano-mcp

Or run directly with npx:

bash
npx @indigoprotocol/cardano-mcp

Docker

bash
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

Configuration

Environment Variables

VariableRequiredDescription
SEED_PHRASEYesYour wallet seed phrase (comma-separated). Never exposed to LLMs.
BLOCKFROST_PROJECT_IDYes*Blockfrost API key from blockfrost.io
KUPO_URLAltKupo endpoint URL (alternative to Blockfrost)
OGMIOS_URLAltOgmios endpoint URL (alternative to Blockfrost)
PORTNoHTTP server port (default: 8000)

*Either BLOCKFROST_PROJECT_ID or both KUPO_URL + OGMIOS_URL are required.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Claude Code (CLI)

Add to ~/.claude/settings.json or .claude/settings.json in your project:

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

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-level):

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

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

OpenClaw

Install Cardano skills for OpenClaw:

bash
openclaw skills add IndigoProtocol/cardano-skills

Skills are automatically configured — start using Cardano wallet tools immediately.

Combined with Indigo MCP

For full Cardano DeFi capabilities, use both Cardano MCP and Indigo MCP together:

json
{  "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"      }    }  }}

Available Tools

Transaction Tools

ToolDescriptionParameters
submit_transactionSign and submit a Cardano transaction from the connected walletcbor: unsigned transaction CBOR hex string

Output: { transactionHash: string, timestamp: number }

Address Tools

ToolDescriptionParameters
get_addressesRetrieve all Cardano addresses for the connected walletNone

Output: { addresses: string[] }

UTxO Tools

ToolDescriptionParameters
get_utxosRetrieve all UTxOs for the connected wallet in raw CBOR formatNone

Output: { utxos: string[] } (CBOR hex encoded)

Balance Tools

ToolDescriptionParameters
get_balancesRetrieve all token balances for the connected walletNone

Output:

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

ADAHandle Tools

ToolDescriptionParameters
get_adahandlesRetrieve all ADAHandles (handle.me) owned by the connected walletNone

Output: { adaHandles: string[] } (e.g., ["$myhandle", "$another"])

Staking Tools

ToolDescriptionParameters
get_stake_delegationRetrieve stake pool delegation and available ADA rewardsNone

Output:

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

Example Usage

Check Wallet Balance

"What's my ADA balance?"

Claude will use get_balances and respond with your ADA and token holdings.

Submit a Transaction

"Submit this transaction: 84a400..."

Claude will use submit_transaction to sign and submit the CBOR transaction, returning the transaction hash.

Check Staking Rewards

"How much staking rewards do I have available?"

Claude will use get_stake_delegation to show your staked pool and claimable rewards.

Resolve ADAHandles

"What ADAHandles do I own?"

Claude will use get_adahandles to list all your handle.me handles.

Troubleshooting

nvm Users (macOS/Linux)

If you use nvm and Claude Desktop shows "server disconnected", you need to use full paths since Claude Desktop doesn't inherit your shell's nvm setup:

json
{  "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"      }    }  }}

Find your node path with: which npx

Cache Issues

If tools fail after an update, clear the npm cache:

bash
rm -rf ~/.npm/_npx

Then restart Claude Desktop.

Platform Support

PlatformStatusNotes
macOS✅ Full supportIntel & Apple Silicon
Windows✅ Full supportWindows 10/11
Linux✅ Full supportx64 & ARM64

Security

⚠️ Important: Your seed phrase is stored locally and used only for wallet operations. It is never exposed to LLMs or external services.

  • The seed phrase is only used by the local Lucid Evolution wallet instance
  • All transaction signing happens locally before submission
  • No private keys are ever transmitted

Related Projects

Disclaimer

By using this Cardano MCP Server and all related tools and technology ("MCP"), you acknowledge and agree that:

  1. Your use of decentralized finance, including MCP and/or AI agents that you empower to manage your digital assets, involves various significant financial risks
  2. These risks include but are not limited to: risk of financial loss caused by MCP design or instructions, impermanent loss, and changes in digital asset prices
  3. You are solely responsible for all MCP actions and transactions
  4. You are solely responsible for securing your seed phrase, private keys, and environment configuration

License

MIT

来源：README.md，提交 c9ff7b6

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分