Cardano Mcp

Cardano MCP サーバー

Model Context Protocol を介して、AI エージェントや自動化システムから 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

次の処理が行われます。

1. 使用しているクライアント（Claude Desktop、Claude Code、Cursor、Windsurf）を確認します
2. Blockfrost Project ID の入力を求めます
3. ウォレットのシードフレーズの入力を求めます（ローカルに保存され、LLM に公開されることはありません）
4. 設定ファイルを自動的に更新します

手動インストール

グローバルにインストールします。

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	はい	ウォレットのシードフレーズ（カンマ区切り）。LLM に公開されることはありません。
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 16 進文字列

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

アドレスツール

ツール	説明	パラメーター
get_addresses	接続されたウォレットの Cardano アドレスをすべて取得します	なし

出力： { addresses: string[] }

UTxO ツール

ツール	説明	パラメーター
get_utxos	接続されたウォレットのすべての UTxO を未加工の CBOR 形式で取得します	なし

出力： { utxos: string[] }（CBOR 16 進エンコード）

残高ツール

ツール	説明	パラメーター
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 ハンドルを一覧表示します。

トラブルシューティング

nvm ユーザー（macOS/Linux）

nvm を使用していて、Claude Desktop に「server disconnected」と表示される場合、Claude Desktop はシェルの 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 を実行して Node のパスを確認します。

キャッシュの問題

アップデート後にツールが動作しない場合は、npm キャッシュをクリアします。

rm -rf ~/.npm/_npx

その後、Claude Desktop を再起動します。

プラットフォームのサポート

プラットフォーム	状態	備考
macOS	✅ 完全サポート	Intel および Apple Silicon
Windows	✅ 完全サポート	Windows 10/11
Linux	✅ 完全サポート	x64 および ARM64

セキュリティ

⚠️ 重要： シードフレーズはローカルに保存され、ウォレット操作にのみ使用されます。LLM や外部サービスに公開されることは決してありません。

• シードフレーズは、ローカルの Lucid Evolution ウォレットインスタンスによってのみ使用されます
• すべてのトランザクションへの署名は、送信前にローカルで行われます
• 秘密鍵が送信されることはありません

関連プロジェクト

• Indigo MCP — Indigo Protocol 向けの 57 個のツール（CDP、ステーキング、安定性プール、DEX）
• Indigo AI Skills — Indigo のワークフロー向け AI エージェントスキル
• Cardano AI Skills — Cardano の操作向け AI エージェントスキル

免責事項

この Cardano MCP Server および関連するすべてのツールとテクノロジー（「MCP」）を使用することで、以下を認識し、同意したものとみなされます。

1. MCP および／またはデジタル資産の管理を委任する AI エージェントを含む、分散型金融の利用には、さまざまな重大な金融リスクが伴います
2. これらのリスクには、MCP の設計や指示に起因する金銭的損失、インパーマネントロス、デジタル資産価格の変動などが含まれますが、これらに限定されません
3. MCP のすべての操作とトランザクションについて、責任を負うのはご自身のみです
4. シードフレーズ、秘密鍵、および環境設定の保護について、責任を負うのはご自身のみです

ライセンス

MIT