Concordium MCP Server

Concordium MCP サーバー

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

クイックセットアップ

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

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

# Setup wizard for deploy scripts
./scripts/wizard.sh

手動セットアップ

# Install deps
pnpm install

# Build
pnpm run build

# Run
node dist/index.js

HTTP

node dist/http-server.js
# Available at 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 - microCCD 単位の 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 [email protected]:Developerayo/concordium-mcp-server.git
cd concordium-mcp-server
pnpm install
pnpm run build

デバッグに MCP Inspector を使用する

MCP Inspector は、メソッドをテストするためのビジュアルインターフェースを提供し、MCP サーバーのデバッグを支援します。

pnpm inspector

これにより MCP Inspector が起動し、ブラウザーからアクセスできるようになります。次のことができます。

• 利用可能なすべてのメソッドを確認する
• さまざまなパラメーターを指定してメソッドをテストする
• レスポンスデータを表示する
• MCP サーバーの問題をデバッグする

ライセンス

MIT