Concordium MCP Server

Concordium MCP 服务

一个 MCP 服务，可让 AI Agent 通过自然语言与 Concordium 链通信。无需编写任何代码，即可查询账户、区块、代币、验证者、智能合约等。

快速设置

Docker 设置

将以下内容添加到你的 MCP 服务配置中（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 代币余额
  • 示例：“查询钱包 3kBx... 在合约 9870,1 上的代币余额”

验证者/资金池

• 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 和选举信息是什么？”

代币相关

• “查询钱包 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF 在合约 9870,1 上的 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