Alchemy MCP 服务器

一个模型上下文协议（MCP）服务器，使AI代理能够以结构化的方式与Alchemy的区块链API进行交互。这允许代理直接查询区块链数据而无需编写任何代码。

<a href="https://glama.ai/mcp/servers/@alchemyplatform/alchemy-mcp-server"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=1408826322,1268151872&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Alchemy Server MCP 服务器" /> </a>

通用用法

此MCP服务器在AI代理和Alchemy的区块链API之间创建了一个桥梁，允许代理执行以下操作：

• 查询代币价格及价格历史（包括灵活的时间框架查询）
• 获取NFT所有权信息和合约数据
• 查看多个网络中的交易历史
• 检查多个区块链网络中的代币余额
• 过滤检索详细的资产转移
• 通过智能合约账户发送交易（需要配置钱包代理服务器）
• 通过DEX协议执行代币交换（需要配置钱包代理服务器）
• 更多！

快速设置

要快速设置MCP服务器，请在您的MCP配置文件中使用以下配置（通常在Claude Desktop或Cursor设置中）：

{
  "mcpServers": {
    "alchemy": {
      "command": "npx",
      "args": [
        "-y",
        "@alchemy/mcp-server"
      ],
      "env": {
        "ALCHEMY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

此配置允许您无需手动克隆仓库即可使用该服务器。

环境变量

MCP服务器需要以下环境变量：

• ALCHEMY_API_KEY - 您的Alchemy API密钥（用于所有区块链数据查询）

对于交易和交换功能，您还必须配置：

• AGENT_WALLET_SERVER - 处理智能合约账户操作的已配置钱包代理服务器的URL

⚠️ 重要：如果没有正确配置的钱包代理服务器，sendTransaction和swap方法将无法工作。这些方法需要外部钱包基础设施来处理签名和广播交易。

可用方法

您可以提示您的AI代理使用以下方法：

代币价格方法

1. fetchTokenPriceBySymbol

   • 根据代币符号获取当前价格数据
   • 示例："ETH和BTC的当前价格是多少？"

2. fetchTokenPriceByAddress

   • 根据合约地址获取当前价格数据
   • 示例："Ethereum主网中地址0x1234...5678的代币价格是多少？"

3. fetchTokenPriceHistoryBySymbol

   • 获取特定日期范围内的代币历史价格数据
   • 示例："显示2023年1月1日至2月1日的BTC价格历史，按天间隔"

4. fetchTokenPriceHistoryByTimeFrame

   • 使用灵活的时间框架或自然语言获取历史价格数据
   • 示例："显示过去一周的ETH价格" 或 "获取过去30天的BTC价格"

跨链代币方法

5. fetchTokensOwnedByMultichainAddresses
   • 获取跨多个网络的地址的代币余额
   • 示例："Ethereum和Base上地址0xabc...123持有的代币是什么？"

交易历史方法

6. fetchAddressTransactionHistory

   • 获取跨多个网络的地址的交易历史
   • 示例："显示Ethereum上钱包0xdef...456的最近交易"

7. fetchTransfers

   • 获取带有高级过滤选项的详细资产转移数据
   • 示例："显示所有ERC-20转移到或来自0xghi...789的交易"

NFT方法

8. fetchNftsOwnedByMultichainAddresses

   • 获取带有垃圾邮件过滤的地址拥有的所有NFT
   • 示例："地址0xjkl...012拥有哪些NFT？"

9. fetchNftContractDataByMultichainAddress

   • 获取地址的NFT合约数据
   • 示例："地址0xmno...345有哪些NFT集合的代币？"

交易方法

10. sendTransaction
    • 通过智能合约账户发送交易
    • ⚠️ 重要：需要带有AGENT_WALLET_SERVER环境变量的已配置钱包代理服务器
    • 示例："向0xpqr...678发送0.1 ETH"

交换方法

11. swap
    • 通过DEX协议（Uniswap）执行代币交换
    • ⚠️ 重要：需要带有AGENT_WALLET_SERVER环境变量的已配置钱包代理服务器
    • 示例："将100 USDC兑换成ETH"

本地开发和开源贡献

安装

1. 克隆仓库

git clone https://github.com/alchemyplatform/alchemy-mcp.git
cd alchemy-mcp

2. 安装依赖

pnpm install

开发

pnpm watch

构建生产版本

pnpm build

使用MCP Inspector进行调试

MCP Inspector通过提供可视界面帮助您调试MCP服务器：

pnpm inspector

这将启动MCP Inspector，您可以在浏览器中访问它。它允许您：

• 查看所有可用的方法
• 使用不同的参数测试方法
• 查看响应数据
• 调试MCP服务器的问题

贡献

欢迎提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

许可证

此MCP服务器根据MIT许可证发布。这意味着您可以在遵守MIT许可证条款和条件的情况下自由使用、修改和分发软件。

示例提示

这里有一些示例提示，您可以与您的AI代理一起使用：

比特币和以太坊的当前价格是多少？

显示Ethereum上钱包0x1234...5678拥有的NFT。

钱包0xabcd...6789在Ethereum和Base上持有哪些代币？

获取0x9876...5432的交易历史。

显示从1月1日到今天的Ethereum价格历史，按天间隔。

获取过去一周的比特币价格数据，按小时间隔。

显示过去一个月的ETH价格表现。

在过去100个区块中，地址0x1234...5678发生了哪些ERC-20转移？

API参考

有关Alchemy的API更多信息，请参阅：

• Alchemy API 文档