Concordium MCP Server

🚀 Concordium MCP Server

Concordium MCP Serverは、AIエージェントが自然言語でConcordiumチェーンと通信できるようにするサーバーです。コードを書かずに、アカウント、ブロック、トークン、バリデーター、スマートコントラクトなどをクエリできます。

🚀 クイックスタート

🐳 Dockerセットアップ

mcp-serverの設定（Claude DesktopまたはCursor）に以下を追加します。

{
  "mcpServers": {
    "concordium": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--network=host", "concordium-mcp-server"],
      "env": {
        "CCD_NETWORK": "mainnet",
        "CCD_PORT": "20000",
        "CCD_SECURE": "true"
      }
    }
  }
}

💻 ローカルセットアップ

Dockerを使用せずにローカル開発を行う場合は、以下の設定を使用します。

{
  "mcpServers": {
    "concordium": {
      "command": "node",
      "args": ["/zeus/workspace/concordium-mcp-server/dist/index.js"],
      "env": {
        "CCD_NETWORK": "mainnet",
        "CCD_PORT": "20000",
        "CCD_SECURE": "true"
      }
    }
  }
}

🚀 デプロイオプション

📝 ワンラインセットアップ

ローカル（Claude Desktopを自動設定）:

./scripts/local-deploy.sh

Docker:

./scripts/docker-deploy.sh

クラウド（HTTP）:

./scripts/fly-deploy.sh
./scripts/railway-deploy.sh
./scripts/render-deploy.sh

セットアップウィザード:

# デプロイスクリプトのセットアップウィザード
./scripts/wizard.sh

🛠️ 手動セットアップ

# 依存関係のインストール
pnpm install

# ビルド
pnpm run build

# 実行
node dist/index.js

HTTP

node dist/http-server.js
# http://localhost:3001/sse で利用可能

⚙️ 環境変数

• CCD_NETWORK - 接続するネットワーク (mainnet または testnet、デフォルト: mainnet)
• CCD_PORT - RPCポート（デフォルト: 20000）
• CCD_SECURE - 安全な接続を使用するかどうか（デフォルト: true）
• CCD_TIMEOUT - リクエストのタイムアウト時間（ミリ秒、デフォルト: 15000）

📚 利用可能なメソッド

👛 アカウント/ウォレット

• get_account_details - 残高やステーキングを含むアカウントの詳細情報
  • 例: "3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF のアカウント詳細を表示して"
• get_account_balance - CCDの残高（マイクロCCD）
  • 例: "アカウント 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF のCCD残高はいくらですか？"
• get_account_staking_details - バリデーター/デリゲーターのステータスとステーキング額
  • 例: "アカウント 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF はステーキングしていますか？"

📦 ブロック

• get_block_details - ハッシュまたは最新のブロック情報
  • 例: "最新のブロック詳細を表示して"
• get_blocks_at_height - 特定の高さのすべてのブロック
  • 例: "高さ 31,058,768 のすべてのブロックを取得して"
• get_block_transaction_events - ブロック内のトランザクションイベント
  • 例: "トランザクションのある最新のブロックのトランザクションイベントを表示して"

💰 トークン

• get_token_balance - CIS-2 トークンの残高
  • 例: "コントラクト 9870,1 上のウォレット 3kBx... のトークン残高を確認して"

👨‍⚖️ バリデーター/プール

• get_validator_list - アクティブなバリデーター（最大 100 件）
  • 例: "すべてのアクティブなバリデーターをリスト表示して"
• get_pool_details - バリデータープールの情報
  • 例: "バリデータープールID 42 の詳細を表示して"
• get_passive_delegation_details - パッシブデリゲーションの情報
  • 例: "現在のパッシブデリゲーションのステータスはどうですか？"

📜 スマートコントラクト

• get_instance_details - コントラクトインスタンスの情報
  • 例: "アドレス 9870,1 のコントラクトの詳細を取得して"
• get_module_list - デプロイされたコントラクトモジュール
  • 例: "最初の 50 個のデプロイされたモジュールをリスト表示して"

🌐 ネットワーク

• get_consensus_details - チェーンのコンセンサスステータス
  • 例: "現在のコンセンサスステータスはどうですか？"
• get_node_details - ノードの情報
  • 例: "ノードの詳細を表示して"
• health_check - ノードのヘルスステータス
  • 例: "ノードは正常ですか？"

💻 使用例

📋 基本的なクエリ

• "3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF のCCD残高はいくらですか？"
• "ネットワーク上の最新のブロックを表示して"
• "すべてのアクティブなバリデーターをリスト表示して"
• "スマートコントラクト 9870,1 の詳細を取得して"

🧩 より複雑なクエリ（一部は複数のツールを必要とする場合があります）

• "アカウント 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF がステーキングしているか確認し、プールの詳細を表示して"
• "最近のブロックのトランザクションイベントを表示して"
• "最近デプロイされた 20 個のコントラクトモジュールを表示して"
• "現在の epoch と選挙情報は何ですか？"

💰 トークン関連

• "コントラクト 9870,1 上のウォレット 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF のCIS-2トークン残高を確認して"
• "アドレス 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF のトークンID '2' のトークン残高を表示して"

🛠️ 開発

📋 前提条件

• Node.js 20+
• pnpmパッケージマネージャー
• Docker（オプション）

📦 ソースからビルド

git clone git@github.com:Developerayo/concordium-mcp-server.git
cd concordium-mcp-server
pnpm install
pnpm run build

🐞 MCPインスペクターを使用したデバッグ

MCPインスペクターは、メソッドをテストするための視覚的なインターフェースを提供することで、MCPサーバーのデバッグを支援します。

pnpm inspector

これにより、ブラウザでアクセスできるMCPインスペクターが起動します。以下のことができます。

• すべての利用可能なメソッドを表示
• 異なるパラメーターでメソッドをテスト
• レスポンスデータを表示
• MCPサーバーの問題をデバッグ

📄 ライセンス

MIT