@alchemy/mcp-server

中文文档
0.3.0发布于 2026/03/27MITES Module构建来源已验证近 30 天下载 3264

用于使用 Alchemy API 的 MCP 服务器

中文使用文档
文档目录19 节
  1. 一般使用
  2. 快速设置
  3. 环境变量
  4. 可用方法
  5. 托肯价格方法
  6. 多链托肯方法
  7. 交易历史方法
  8. NFT 方法
  9. 交易方法
  10. 交换方法
  11. 地方发展和开放源码捐款
  12. 安装
  13. 发展
  14. 生产大楼
  15. 使用 MCP 调试检查器
  16. 捐款
  17. 许可证
  18. 示例提示
  19. API 参考

Alchemy MCP 服务器

一个模型上下文协议(MCP)服务器,使AI代理能够以有条理的方式与Alchemy的块链API互动. 这允许代理直接查询块链数据而无需写入任何代码.

Alchemy Server MCP server

一般使用

这个MCP服务器在AI代理和Alchemy的块链API之间建立了桥梁,允许代理商:

  • 查询象征性价格和价格历史(包括灵活的时间框架查询)
  • 获取 NFT 所有权信息和合同数据
  • 通过多个网络查看交易历史
  • 核对多个区块链网络的证券余额
  • 通过过滤获取详细资产转让
  • 通过智能合同账户发送交易需要配置钱包代理服务器(中文(简体) )
  • 通过 DEX 协议执行令牌互换( E)需要配置钱包代理服务器(中文(简体) )
  • 还有更多!

快速设置

要快速设置 MCP 服务器, 请在您的 MCP 配置文件中使用以下配置( 通常在 Claude 桌面或光标设置中):

{
  "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. 获取 TokenPriceBySymbol

    • 按符号获取当期令牌价格数据
    • 示例:"ETH和BTC的当前价格是多少"
  2. 获取 TokenPriceByAddress

    • 按合同地址获取当期令牌价格数据
    • 示例:"在埃特鲁姆主网0x1234.5678的地址上,信使的价格是多少"
  3. 获取 TokenPrice历史符号

    • 获得具有特定日期范围的令牌的历史价格数据
    • 示例:"给我展示从一月一日至一月一日的BTC价格历史,每日间隔"
  4. 获取 TokenPrice历史 ByTimeFrame

    • 使用灵活的时间框架或自然语言获取历史价格数据
    • 例子:"给我看看上周的ETH价格"或"过去30天的BTC价格"

多链托肯方法

  1. 获取自有的多链地址
    • 获得多个网络地址的符号余额
    • 例:"0xabc... 123在"伊特鲁姆"和"基地"上持有什么标志?

交易历史方法

  1. 获取地址交易历史

    • 获取多个网络地址的交易历史
    • 示例:“在Ethereum上显示钱包 0xdef...456的最近交易”
  2. 获取传输器

    • 获取带有高级过滤选项的详细资产转移数据
    • 例:"给我看ERC-20的所有转帐来往于0xghi. . 789"

NFT 方法

  1. 获取自有多链地址

    • 获取所有 NFT 由垃圾邮件过滤地址拥有
    • 例:"NFTs是0xjkl.012拥有的"
  2. 获取NftContactDataBy 多链地址

    • 获取 NFT 地址合同数据
    • 例:"0xmno. 345的NFT收藏有从何而来

交易方法

  1. 发送交易
    • 通过智能合同账户发送交易
    • 重要吗: 需要配置的钱包代理服务器 AGENT_WALLET_SERVER 环境变量
    • 示例:“将 0.1 ETH 发送到 0xpqr. 678”

交换方法

  1. 互换
    • 通过DEX协议执行令牌互换( Uniswap)
    • 重要吗: 需要配置的钱包代理服务器 AGENT_WALLET_SERVER 环境变量
    • 示例: "Swap 100 USDC for EH"

地方发展和开放源码捐款

安装

  1. 清除仓库
git clone https://github.com/alchemyplatform/alchemy-mcp.git
cd alchemy-mcp
  1. 安装依赖关系
pnpm install

发展

pnpm watch

生产大楼

pnpm build

使用 MCP 调试检查器

MCP 检查器帮助您调试您的 MCP 服务器, 提供视觉界面测试您的方法 :

pnpm inspector

这将启动您可以在浏览器中访问的 MCP 检查器 。 它允许你:

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

捐款

欢迎拉动请求。 对于重大变动,请先开出一个问题来讨论你想要改变什么.

许可证

这个MCP服务器根据麻省理工学院许可证获得许可. 这意味着您可以自由使用,修改并分发软件,但须遵守麻省理工学院许可证的条款和条件.

示例提示

以下是您可用人工智能代理的提示:

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/mcp-server 共发布 12 个版本,首次发布于 2025/04/17;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.3.0latest2026/03/277 个月前
0.2.22026/03/217 个月前
0.2.0-rc.0rc2025/08/081.3 年前
0.1.82025/07/091.3 年前
0.1.72025/07/041.3 年前
0.1.62025/07/041.3 年前

关于 @alchemy/mcp-server 的常见问题

@alchemy/mcp-server 是什么?

用于使用 Alchemy API 的 MCP 服务器

如何安装 @alchemy/mcp-server?

在项目目录运行 npm install @alchemy/mcp-server,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-server-alchemy,可以用 npx mcp-server-alchemy 直接运行。

@alchemy/mcp-server 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/alchemy__mcp-server 是否存在。

@alchemy/mcp-server 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@alchemy/mcp-server 可以商用吗?

@alchemy/mcp-server 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@alchemy/mcp-server 的下载量有多少?

根据 npm 官方下载统计,@alchemy/mcp-server 在 2026/10/06 – 2026/11/04 这 30 天内被下载 3,264 次,日均约 109 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@alchemy/mcp-server 还在维护吗?

最新版本 0.3.0 发布于 2026/03/27(7 个月前);至今共发布 12 个版本,其中过去 12 个月发布了 2 个;首次发布于 2025/04/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。