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 许可证。