项目简介

Alchemy MCP 服务器是基于 Model Context Protocol (MCP) 实现的后端服务,它充当 AI 代理与 Alchemy 区块链 API 之间的桥梁。通过这个服务器,AI 代理可以直接访问丰富的链上数据和服务,而无需理解复杂的 API 调用细节或编写代码。

主要功能点

  • 代币信息查询: 获取主流代币的当前价格、历史价格以及通过合约地址查询代币价格。
  • 多链资产查询: 查询指定钱包地址在多个区块链网络上的代币余额和 NFT 持有情况。
  • 交易历史追踪: 获取钱包地址在不同网络上的交易记录和资产转移详情(包括 ERC-20 等代币转移)。
  • NFT 数据访问: 获取钱包拥有的 NFT 列表及其合约相关信息。

安装步骤

要在本地环境中运行此 MCP 服务器,请按照以下步骤操作:

  1. 克隆仓库:
    git clone https://github.com/alchemyplatform/alchemy-mcp-server.git
    cd alchemy-mcp-server
  2. 安装依赖:
    pnpm install
    (请确保您已安装 Node.js 和 pnpm)

服务器配置

此 MCP 服务器是供 MCP 客户端(如支持 MCP 的 AI 桌面应用或 IDE)使用的。您需要在客户端的设置中添加服务器的启动配置。典型的配置是一个 JSON 对象,指定如何启动此服务器进程。

以下是配置示例(请根据您的客户端类型查找 MCP 服务器设置位置):

{
  "mcpServers": {
    "alchemy": {             // 您给服务器定义的名称,在客户端中唯一
      "command": "npx",      // 启动服务器的可执行命令,这里使用 npx 运行 npm 包
      "args": [              // 传递给 command 命令的参数列表
        "-y",                // npx 的一个参数,用于自动确认安装 @alchemy/mcp-server
        "@alchemy/mcp-server" // 要通过 npx 运行的 npm 包名
      ],
      "env": {               // 启动服务器进程时要设置的环境变量
        "ALCHEMY_API_KEY": "YOUR_API_KEY" // **重要:您的 Alchemy API 密钥**
      }
    }
  }
}

请将 '"YOUR_API_KEY"' 替换为您在 Alchemy 平台获取的真实 API 密钥。客户端将使用此配置启动服务器进程并通过标准输入/输出(Stdio)与之通信。

基本使用方法

配置完成后,启动您的 MCP 客户端。AI 代理现在可以通过调用服务器提供的功能(工具)来访问区块链数据。您可以使用自然语言向 AI 代理提问,AI 会识别您的意图并使用配置的 Alchemy MCP 服务器来获取信息。

例如,您可以尝试以下类似的提示:

  • "告诉我以太坊(ETH)现在的价格。"
  • "地址 0xabcdef1234567890 在 Polygon 上有什么代币?"
  • "获取钱包 0x1234567890abcdef 最近的交易记录。"
  • "显示地址 0xfedcba0987654321 拥有的所有 NFT。"
  • "请提供比特币从2023年1月1日到2月1日的每日价格历史。"

AI 代理会根据您的问题自动调用 MCP 服务器上对应的工具并返回结果。

信息

分类

网页与API