关键词

区块链数据AvalancheEVM链链上指标Web3工具

AvaCloud MCP工具集使用说明

AvaCloud SDK TypeScript是一个用于集成AvaCloud区块链服务的工具集。此仓库包含一个可安装的MCP服务器实现，能将SDK提供的数据API和功能作为工具暴露给AI应用（如Claude、Cursor等），enabling LLMs to interact with AvaCloud services conversationally.

主要功能点

作为MCP服务器，它主要提供以下功能：

  • 区块链数据访问: 查询EVM链和Primary Network的区块、交易、余额、UTXO等数据。
  • NFT与ICM查询: 获取NFT信息和跨链消息（ICM）详情。
  • 链上指标: 获取链、网络、子网相关的统计和度量数据。
  • 链上探索: 执行复合查询以探索链上实体。
  • Webhooks管理: 创建、列出、更新、删除和管理链上活动Webhooks。

安装步骤

  1. 确保您已安装Node.js (v20或更高版本)。

  2. 使用npm、pnpm、bun或yarn安装 '@avalabs/avacloud-sdk' 包：

    npm add @avalabs/avacloud-sdk

    或者使用其他包管理器，例如pnpm或bun。

服务器配置

MCP客户端（如Claude Desktop、Cursor）需要一个JSON配置文件来定义可用的MCP服务器。您可以将以下结构添加到您的客户端配置文件中，例如 'claude_desktop_config.json' 或 '.cursor/mcp.json'：

{
  "mcpServers": {
    "您的服务器名称": {
      "command": "npx",
      "args": [
        "-y", "--package", "@avalabs/avacloud-sdk",
        "--",
        "mcp", "start",
        // 以下参数需要根据您的实际AvaCloud配置填写
        "--server-url", "您的AvaCloud API端点", // 例如：https://api.example.com
        "--api-key", "您的AvaCloud API Key",   // 您的AvaCloud API密钥
        "--chain-id", "默认链ID",            // 可选，例如："43114" (Avalanche C-Chain)
        "--network", "网络类型"              // 可选，例如："mainnet" 或 "fuji"
      ]
    }
  }
}

请将'您的服务器名称'替换为您喜欢的名称，并根据您的AvaCloud账户和需要访问的网络填写'--server-url'、'--api-key'等参数。MCP服务器将使用'npx'命令启动，运行'@avalabs/avacloud-sdk'包中的'mcp start'命令，并带上您提供的参数连接到AvaCloud API。更多参数可以通过运行'npx -y --package @avalabs/avacloud-sdk -- mcp start --help'查看。

您也可以从GitHub Releases下载预编译的standalone二进制文件来运行MCP服务器，具体请参考仓库文档。

基本使用方法

配置完成后，启动您的MCP客户端。客户端会自动检测并连接到配置的MCP服务器。您可以在与LLM的对话中直接提问或请求与AvaCloud数据或功能相关的信息，例如：

  • “查询地址 '0x...' 在Avalanche C-Chain上的原生币余额。”
  • “列出某个ERC-721合约的所有者。”
  • “获取当前网络验证器的统计数据。”

LLM将通过MCP协议调用由该服务器暴露的相应工具来回答您的请求。

信息

分类

AI与计算

访问项目