alchemy-mcp

Alchemy MCP

在 AI 客户端中使用托管的 Alchemy MCP 服务，获取实时区块链数据、模拟交易、追踪交易、查询 NFT/投资组合，以及管理 Alchemy 应用。

何时使用此技能

当以下条件全部满足时，使用 alchemy-mcp：

• 用户需要实时 Agent 工作——由 Agent 在当前会话中立即执行实时查询、分析、管理工作或本机自动化
• MCP 兼容客户端（Claude Code、Codex、Cursor、Claude Desktop、VS Code Copilot 等）已连接到 https://mcp.alchemy.com/mcp，或者用户愿意添加该服务
• 本地未安装 Alchemy CLI（@alchemy/cli）

如果本地已安装 CLI，或者 CLI 和 MCP 都可用，请改用 alchemy-cli 技能。CLI 是首选的本地备用运行时方案。

何时使用其他技能

情况	改用此技能
本地已安装 @alchemy/cli，或者 CLI 和 MCP 都可用	alchemy-cli
CLI 和 MCP 均不可用	安装 alchemy-cli（npm i -g @alchemy/cli），然后使用 alchemy-cli
使用 Alchemy API 密钥构建在此 Agent 会话之外运行的应用代码	alchemy-api
不使用 API 密钥构建应用代码，或构建需要自我支付费用的自主 Agent，或你明确需要 x402/MPP	agentic-gateway

不要使用此技能编写生产应用代码——MCP 工具用于实时 Agent 工作，不适合嵌入已发布的软件。

连接客户端

服务运行于 https://mcp.alchemy.com/mcp，并通过 OAuth 进行身份验证——首次使用时，客户端会打开浏览器，让你使用 Alchemy 账号登录。无需 API 密钥或本地安装。

Claude Code

最快捷的方式是使用官方的 Alchemy Claude Plugin。它将此 MCP 服务、斜杠命令（/alchemy:balance、/alchemy:nfts、/alchemy:portfolio 等）以及 Alchemy Agent 技能整合在一次安装中：

/plugin marketplace add alchemyplatform/alchemy-claude-plugin
/plugin install alchemy@alchemy

然后运行 /alchemy:setup，为此会话选择一个应用。首次调用 Alchemy 工具时会自动打开 OAuth 登录页面。

若要只连接 MCP 服务而不安装插件，请使用手动命令：

claude mcp add alchemy --transport http https://mcp.alchemy.com/mcp

重启 Claude Code，然后运行 /mcp 并选择 alchemy 进行身份验证。

Codex

codex mcp add alchemy --url https://mcp.alchemy.com/mcp

使用 codex mcp list 验证。

Cursor

添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）：

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

重启 Cursor，并在 Cursor Settings > MCP 中验证。

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

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

VS Code Copilot

添加到项目中的 .vscode/mcp.json：

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

其他任何 MCP 客户端

通过 Streamable HTTP 传输连接到 https://mcp.alchemy.com/mcp。该服务支持带 PKCE 的 OAuth 2.1；客户端会自动处理授权流程。

引导工作流

连接服务并通过 OAuth 登录后：

1. 列出应用 — 使用 list_apps 查看你的 Alchemy 应用。
2. 选择应用 — 使用应用 ID 调用 select_app。此操作会缓存服务供 RPC 和 Data 工具使用的 API 密钥。调用任何 RPC 或 Data 工具前都必须执行此操作。
3. 运行工具 — 调用 159 个工具中的任意一个（例如 getTokenPricesBySymbol、getNFTsForOwner、simulateAssetChanges、solana_getBalance）。

如果需要先创建应用：

create_app(name="My App", networks=["eth-mainnet", "base-mainnet"])

然后针对新应用调用 select_app。

工具目录

此服务提供 159 个工具，分为三类。

管理（8 个工具）— 账户与应用管理

工具	用途
ping	健康检查
list_apps	列出你的 Alchemy 应用
get_app	获取应用详情
select_app	选择一个应用，并缓存其 API 密钥以供 RPC/Data 工具使用
create_app	创建新应用
update_app	更新应用名称或描述
list_chains	列出所有 100 多个受支持的网络
update_allowlist	更新应用允许列表（网络、地址、来源、IP）

RPC（123 个工具）— 链上 JSON-RPC

标准 EVM RPC、Token API、转账与收据、交易模拟、Trace API、Debug API、ERC-4337 账户抽象、Solana 标准 RPC，以及 Solana 增强功能与 DAS。

类别	数量	示例
标准 EVM RPC	31	ethBlockNumber、ethGetBalance、ethCall、ethGetLogs、ethCallBundle
Token API	3	getTokenBalances、getTokenMetadata、getTokenAllowance
转账与收据	2	getAssetTransfers、getTransactionReceipts
交易模拟	5	simulateAssetChanges、simulateExecution、simulateUserOperationAssetChanges
Trace API	6	traceCall、traceTransaction、traceBlock、traceFilter
Debug API	6	debugTraceTransaction、debugTraceCall、debugTraceBlockByNumber
ERC-4337 账户抽象	7	estimateUserOperationGas、getUserOperationReceipt、requestGasAndPaymasterAndData
Solana 标准 RPC	50	solana_getBalance、solana_getTokenAccountsByOwner、solana_getBlock、solana_simulateTransaction
Solana 增强功能与 DAS	13	solana_getAsset、solana_getAssetsByOwner、solana_searchAssets、solana_getPriorityFeeEstimate

数据（28 个工具）— REST API

类别	数量	示例
NFT API	21	getNFTsForOwner、getNFTMetadata、getOwnersForNFT、getFloorPrice、getNFTsForContract
Prices API	3	getTokenPricesBySymbol、getTokenPricesByAddress、getHistoricalTokenPrices
投资组合（多链）	4	getTokensByAddress、getTokenBalancesByAddress、getNFTsByAddress、getNFTContractsByAddress

常见任务 → 工具对照表

任务	工具	备注
最新 ETH 区块号	ethBlockNumber	传入 network: "eth-mainnet"
地址的 ETH 余额	ethGetBalance	返回十六进制 wei
ERC-20 余额	getTokenBalances	使用 getTokenMetadata 获取符号和小数位数
ERC-20 元数据	getTokenMetadata	名称、符号、小数位数、徽标
资产转账（历史记录）	getAssetTransfers	按 category 过滤（erc20、erc721、erc1155、external、internal）
模拟交易	simulateAssetChanges	执行前资产变动
追踪交易	traceTransaction	内部调用树
调试追踪交易	debugTraceTransaction	Geth 风格的结构化追踪
列出拥有的 NFT	getNFTsForOwner	查询单条链
多链 NFT	getNFTsByAddress	查询多条链
NFT 元数据	getNFTMetadata	按 Token ID 查询
NFT 地板价	getFloorPrice	来自主要市场
Token 价格（现货）	getTokenPricesBySymbol	例如 ["ETH","USDC"]
Token 价格（历史）	getHistoricalTokenPrices	按时间范围查询
多链投资组合	getTokenBalancesByAddress	包含 USD 价值
Solana 余额	solana_getBalance	Lamports
Solana Token 账户	solana_getTokenAccountsByOwner	SPL Token
压缩 NFT 查询	solana_getAsset	DAS 标准
所有者的压缩 NFT	solana_getAssetsByOwner	DAS 标准
Solana 优先费	solana_getPriorityFeeEstimate	最近样本
User Operation 收据	getUserOperationReceipt	ERC-4337

操作规则

• 在调用任何 RPC 或 Data 工具之前，务必先调用 select_app。如果未选择应用，工具会报错并给出清晰提示。
• 使用 list_chains 返回的规范链 slug（例如 eth-mainnet、base-mainnet、solana-mainnet）。工具的错误消息会在猜错时提供指引。
• 不要在 Agent 内通过原始 curl/HTTP 绕过 MCP 服务——那是 alchemy-api 所涉及的 API 密钥路径。MCP 工具是此技能的规范接口。
• 不要使用 MCP 工具生成生产应用代码。 用户需要发布代码时，请转交给 alchemy-api（使用 API 密钥）或 agentic-gateway（不使用 API 密钥）。

支持的链

支持 100 多条链，包括 Ethereum、Base、Polygon、Arbitrum、Optimism、BNB、Solana、Starknet、zkSync、Scroll、Linea、Mantle、Blast、World Chain 等。使用 list_chains 获取完整列表。

故障排除

“未选择应用”

使用所需的应用 ID 调用 select_app。如果还没有应用，请先运行 create_app。

OAuth 流程未打开

添加服务后，请重启 MCP 客户端。对于 Claude Code，运行 /mcp 并选择 alchemy，以手动触发登录流程。

找不到工具

有些工具采用命名空间（例如，Solana 工具使用 solana_*）。使用 list_chains 确认链 slug，并查看上方的工具目录以确认准确名称。

速率限制／计算单元

MCP 服务继承所选应用的速率限制。在 Alchemy 控制面板中查看用量。

官方链接

• Alchemy MCP 服务（托管）
• GitHub 上的 Alchemy MCP 源代码
• Alchemy 开发者文档
• Model Context Protocol
• Alchemy 控制面板