使用说明

卡尔达诺MCP服务器

MCP服务器，用于与 卡尔达诺区块链 通过人工智能代理和自动化系统模型上下文协议.

部分 Indigo AI堆栈 --一起使用 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项目ID
提示输入您的钱包种子短语（存储在本地，从不暴露于LLM）
自动更新配置文件

手动安装

全局安装：

npm install -g @indigoprotocol/cardano-mcp

或者直接使用npx运行：

npx @indigoprotocol/cardano-mcp

码头工人

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`	是	您的钱包种子短语（逗号分隔）。从未接触过LLMs。
`BLOCKFROST_PROJECT_ID`	是*	Blockfrost API密钥来自 blockfrost.io
`KUPO_URL`	Alt	Kupo端点URL（Blockfrost的替代方案）
`OGMIOS_URL`	Alt	Ogmios端点URL（Blockfrost的替代方案）
`PORT`	否	HTTP服务器端口（默认值：8000）

*要么 BLOCKFROST_PROJECT_ID 或两者 KUPO_URL + OGMIOS_URL 是必需的。

克劳德桌面版

添加 ~/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"
      }
    }
  }
}

克劳德代码（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/mcp.json （全球）或 .cursor/mcp.json （项目层面）：

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

帆板运动

添加 ~/.codeium/windsurf/mcp_config.json:

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

龙虾

安装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`	检索所有ADA句柄(handle.me)由连接的钱包拥有	无

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

打桩工具

工具	说明	参数
`get_stake_delegation`	检索权益池委托和可用ADA奖励	无

输出：

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

示例用法

检查钱包余额

"What's my ADA balance?"

克劳德将使用 get_balances 并回复您的ADA和代币持有量。

提交交易

"Submit this transaction: 84a400..."

克劳德将使用 submit_transaction 签署并提交CBOR交易，返回交易哈希。

查看质押奖励

"How much staking rewards do I have available?"

克劳德将使用 get_stake_delegation 展示您的赌注池和可领取的奖励。

解析ADA手柄

"What ADAHandles do I own?"

克劳德将使用 get_adahandles 列出所有handle.me手柄。

故障排除

nvm用户（macOS/Linux）

如果您使用nvm并且Claude Desktop显示“服务器已断开连接”，则需要使用完整路径，因为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"
      }
    }
  }
}

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

缓存问题

如果工具在更新后失败，请清除npm缓存：

rm -rf ~/.npm/_npx

然后重新启动Claude Desktop。

平台支持

平台	状态	注释
macOS	✅ 全面支持	英特尔和苹果硅
Windows	✅ 完全支持	Windows 10/11
Linux	✅ 完全支持	x64和ARM64

安全

⚠️ 重要提示： 您的种子短语存储在本地，仅用于钱包操作。它是从不暴露于LLM或外部服务。

种子短语仅由本地Lucid Evolution钱包实例使用
所有交易签名在提交之前都在本地进行
从不传输私钥

免责声明

通过使用卡尔达诺MCP服务器和所有相关工具和技术（“MCP”），您承认并同意：

您使用去中心化金融，包括您授权管理数字资产的MCP和/或AI代理，涉及各种重大金融风险
这些风险包括但不限于：MCP设计或指令造成的财务损失风险、非永久性损失以及数字资产价格的变化
您对所有MCP行动和交易负全部责任
您全权负责保护种子短语、私钥和环境配置的安全

许可证

麻省理工学院

Cardano区块链交互服务器

使用说明

卡尔达诺MCP服务器

⚡ 2命令开始

特性

快速开始

自动设置（推荐）

手动安装

码头工人

配置

环境变量

克劳德桌面版

克劳德代码（CLI）

光标

帆板运动

龙虾

结合Indigo MCP

可用工具

交易工具

地址工具

UTxO工具

平衡工具

ADAHandle工具

打桩工具

示例用法

检查钱包余额

提交交易

查看质押奖励

解析ADA手柄

故障排除

nvm用户（macOS/Linux）

缓存问题

平台支持

安全

相关项目

免责声明

许可证

使用说明

卡尔达诺MCP服务器

⚡ 2命令开始

特性

快速开始

自动设置（推荐）

手动安装

码头工人

配置

环境变量

克劳德桌面版

克劳德代码（CLI）

光标

帆板运动

龙虾

结合Indigo MCP

可用工具

交易工具

地址工具

UTxO工具

平衡工具

ADAHandle工具

打桩工具

示例用法

检查钱包余额

提交交易

查看质押奖励

解析ADA手柄

故障排除

nvm用户（macOS/Linux）

缓存问题

平台支持

安全

相关项目

免责声明

许可证

相关 MCP

比特币SV MCP服务器

Solana区块链交互服务器

Starknet区块链服务器

区块链数据访问服务器

区块链集成服务器

NFT市场集成服务器