Concordium MCP Server

🚀 Concordium MCP Server

Concordium MCP Server 是一個允許 AI 代理通過自然語言與 Concordium 區塊鏈進行通信的服務器。無需編寫任何代碼，即可查詢賬戶、區塊、代幣、驗證器、智能合約等信息。

🚀 快速開始

容器化部署

將以下內容添加到你的 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

• 容器化部署：

./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 - 獲取賬戶的完整詳細信息，包括餘額和質押信息
  • 示例："Show me account details for 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF"
• get_account_balance - 獲取賬戶的 CCD 餘額（以微 CCD 為單位）
  • 示例："What's the CCD balance of account 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF?"
• get_account_staking_details - 獲取賬戶的驗證器/委託狀態和質押金額
  • 示例："Is account 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF staking?"

區塊

• get_block_details - 根據哈希或獲取最新區塊信息
  • 示例："Show me the latest block details"
• get_blocks_at_height - 獲取特定高度的所有區塊
  • 示例："Get all blocks at height 31,058,768"
• get_block_transaction_events - 獲取區塊中的交易事件
  • 示例："Show me transaction events from the latest block with transactions"

代幣

• get_token_balance - 獲取 CIS-2 代幣餘額
  • 示例："Check token balance for wallet 3kBx... on contract 9870,1"

驗證器/池

• get_validator_list - 獲取活躍驗證器列表（限制為 100 個）
  • 示例："List all active validators"
• get_pool_details - 獲取驗證器池的詳細信息
  • 示例："Show details for validator pool ID 42"
• get_passive_delegation_details - 獲取被動委託信息
  • 示例："What's the current passive delegation status?"

智能合約

• get_instance_details - 獲取合約實例的詳細信息
  • 示例："Get details for contract at address 9870,1"
• get_module_list - 獲取已部署的合約模塊列表
  • 示例："List the first 50 deployed modules"

網絡

• get_consensus_details - 獲取鏈的共識狀態
  • 示例："What's the current consensus status?"
• get_node_details - 獲取節點的詳細信息
  • 示例："Show node details"
• health_check - 檢查節點的健康狀態
  • 示例："Is the node healthy?"

💻 使用示例

基礎查詢

• "What is the CCD balance of: 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF?"
• "Show me the latest block on the network"
• "List all active validators"
• "Get details for smart contract 9870,1"

複雜查詢（部分查詢可能涉及多個工具）

• "Check if account 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF is staking and show me the pool details"
• "Show me transaction events in recent blocks"
• "Show me the 20 most recent deployed contract modules"
• "What's the current epoch and election information?"

代幣相關查詢

• "Check CIS-2 token balance for wallet 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF on contract 9870,1"
• "Show token balance with token ID '2' for address 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF"

📚 開發指南

前提條件

• 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 許可證。