Alchemy MCP 服务器

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

远程 MCP 服务器（推荐）

开始使用的最快方法是连接到托管的远程服务器 https://mcp.alchemy.com/mcp。它通过 OAuth 进行身份验证——只需在提示时使用您的 Alchemy 账户登录即可。无需 API 密钥或本地安装。

完整文档： alchemy.com/docs/alchemy-mcp-server

注意： 托管服务器 mcp.alchemy.com 和此开源仓库是分开维护的，可能不会同步。

{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

{
  "servers": {
    "alchemy": {
      "type": "http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

对于任何其他兼容 MCP 的客户端，请使用 Streamable HTTP 传输将其指向 https://mcp.alchemy.com/mcp。

Related MCP server: Substrate MCP Server

本地 STDIO 服务器

此 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

   • 按合约地址获取代币的当前价格数据

   • 示例：“以太坊主网上地址为 0x1234...5678 的代币价格是多少？”

3. fetchTokenPriceHistoryBySymbol

   • 获取具有特定日期范围的代币历史价格数据

   • 示例：“显示 2023 年 1 月 1 日至 2 月 1 日的 BTC 价格历史，按日间隔显示”

4. fetchTokenPriceHistoryByTimeFrame

   • 使用灵活的时间范围或自然语言获取历史价格数据

   • 示例：“显示过去一周的 ETH 价格”或“获取过去 30 天的 BTC 价格”

多链代币方法

5. fetchTokensOwnedByMultichainAddresses

   • 获取跨多个网络的地址的代币余额

   • 示例：“0xabc...123 在以太坊和 Base 上持有哪些代币？”

交易历史方法

6. fetchAddressTransactionHistory

   • 获取跨多个网络的地址的交易历史

   • 示例：“显示以太坊上钱包 0xdef...456 的近期交易”

7. fetchTransfers

   • 获取带有高级过滤选项的详细资产转账数据

   • 示例：“显示所有发送到或来自 0xghi...789 的 ERC-20 转账”

NFT 方法

8. fetchNftsOwnedByMultichainAddresses

   • 获取地址拥有的所有 NFT（带有垃圾邮件过滤）

   • 示例：“0xjkl...012 拥有哪些 NFT？”

9. fetchNftContractDataByMultichainAddress

   • 获取地址的 NFT 合约数据

   • 示例：“0xmno...345 拥有哪些 NFT 系列的代币？”

交易方法

10. sendTransaction

    • 通过智能合约账户发送交易

    • ⚠️ 重要：需要配置带有 AGENT_WALLET_SERVER 环境变量的钱包代理服务器

    • 示例：“发送 0.1 ETH 到 0xpqr...678”

兑换方法

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 服务器的问题

贡献

欢迎提交 Pull Request。对于重大更改，请先开启一个 issue 来讨论您想要更改的内容。

许可证

此 MCP 服务器采用 MIT 许可证授权。这意味着您可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。

示例提示词

以下是您可以与 AI 代理一起使用的一些示例提示词：

What's the current price of Bitcoin and Ethereum?

Show me the NFTs owned by the wallet 0x1234...5678 on Ethereum.

What tokens does wallet 0xabcd...6789 hold across Ethereum and Base?

Get me the transaction history for 0x9876...5432.

Show me the price history of Ethereum from January 1st to today with daily intervals.

Get me Bitcoin price data for the last week with hourly intervals.

Show me ETH price performance for the past month.

What ERC-20 transfers happened to address 0x1234...5678 in the last 100 blocks?

API 参考

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

• Alchemy API 文档