Alchemy MCP 是 Alchemy 提供的托管式 Model Context Protocol 服务器，地址为 https://mcp.alchemy.com/mcp。它让 AI 客户端在会话中直接调用实时区块链数据工具，并完成 Alchemy 应用的管理操作。服务器通过 OAuth 认证：首次使用时客户端会打开浏览器，让用户登录 Alchemy 账号，因此不需要 API key，也不需要本地安装。
适用场景：当用户希望在当前 AI 会话中实时查询链上数据、进行分析、做应用管理，或让智能体立即执行与链上数据相关的操作，并且该会话已经连接 Alchemy MCP 服务器时，可使用本工具。
不适用场景：如果要编写在智能体会话之外运行的应用代码，应改用 alchemy-api；如果还没有 API key，也走 alchemy-api，并从 Alchemy Dashboard（https://dashboard.alchemy.com）复制密钥。MCP 工具面向会话内的实时操作，不用于嵌入最终交付的软件，因此不应使用它生成生产应用代码，也不应在智能体内用原始 curl/HTTP 绕过 MCP 服务器。
接入方式：最便捷的路径是官方 Alchemy Claude Plugin，它同时打包了本 MCP 服务器、斜杠命令（如 /alchemy:balance、/alchemy:nfts、/alchemy:portfolio）以及 alchemy-mcp 和 alchemy-api 两个技能。安装命令为： /plugin marketplace add alchemyplatform/alchemy-claude-plugin /plugin install alchemy@alchemy 安装后运行 /alchemy:setup 为会话选择应用，首次调用 Alchemy 工具时会自动触发 OAuth 登录。
基本使用流程：服务器连接并完成 OAuth 登录后，先调用 list_apps 列出 Alchemy 应用，再用 select_app 传入应用 ID 选择应用，这会缓存服务器用于 RPC 和 Data 工具的 API key，任何 RPC 或 Data 工具调用之前都必须完成这一步。随后可调用 150 多个工具，例如 getTokenPricesBySymbol、getNFTsForOwner、simulateAssetChanges、solana_getBalance。若尚无应用，可先调用 create_app(name="My App", chain_networks=["eth-mainnet", "base-mainnet"]) 创建，再 select_app。
工具目录：该插件配置中共有 171 个工具，资料给出的是部分目录。管理类工具共 23 个，资料列出其中 8 个：ping（健康检查）、list_apps（列出应用）、get_app（查看应用详情）、select_app（选择应用并缓存 API key）、create_app（创建应用）、update_app（更新名称或描述）、list_chains（列出 100 多个支持网络）、update_allowlist（更新网络、地址、来源、IP 白名单）；未列出的包括团队、Webhook、Gas Manager 策略、用量和反馈等工具。RPC 类共 120 个，包括标准 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 账户抽象 5 个（estimateUserOperationGas、getUserOperationReceipt、getUserOperationByHash）、Solana 标准 RPC 49 个（solana_getBalance、solana_getTokenAccountsByOwner、solana_getBlock、solana_simulateTransaction）、Solana Enhanced & DAS 13 个（solana_getAsset、solana_getAssetsByOwner、solana_searchAssets、solana_getPriorityFeeEstimate）。Data 类共 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（按 erc20、erc721、erc1155、external、internal 等类别过滤）；预演交易用 simulateAssetChanges；追踪交易用 traceTransaction；Geth 风格调试追踪用 debugTraceTransaction；查询某地址在某条链上的 NFT 用 getNFTsForOwner；跨链查询 NFT 用 getNFTsByAddress；查询 NFT 元数据用 getNFTMetadata；查询 NFT 地板价用 getFloorPrice；查询代币现货价格用 getTokenPricesBySymbol；查询历史价格用 getHistoricalTokenPrices；查询带美元价值的多链资产组合用 getTokenBalancesByAddress；查询 Solana 余额用 solana_getBalance（lamports）；查询 SPL 代币账户用 solana_getTokenAccountsByOwner；查询压缩 NFT 用 solana_getAsset；查询某地址的全部压缩 NFT 用 solana_getAssetsByOwner；查询 Solana 优先费估算用 solana_getPriorityFeeEstimate；查询 ERC-4337 用户操作回执用 getUserOperationReceipt。
操作规则：调用任何 RPC 或 Data 工具前必须先执行 select_app；未选择应用时工具会明确报错。链标识应使用 list_chains 返回的规范 slug（如 eth-mainnet、base-mainnet、solana-mainnet），猜测错误时工具错误信息会给出提示。
支持的链：100 多条，包括 Ethereum、Base、Polygon、Arbitrum、Optimism、BNB、Solana、Starknet、zkSync、Scroll、Linea、Mantle、Blast、World Chain 等，可通过 list_chains 获取完整列表。
常见问题：若提示 “No app selected”，先用目标应用 ID 调用 select_app；若还没有应用，先 create_app。若 OAuth 流程未打开，添加服务器后重启 MCP 客户端；在 Claude Code 中可运行 /mcp 并选择 alchemy 手动触发登录。若工具未找到，注意部分工具带命名空间（如 Solana 的 solana_*），用 list_chains 确认链 slug，并核对上述工具名。速率限制和计算单元继承所选应用的配额，可在 Alchemy Dashboard 查看用量。
官方链接包括：托管的 Alchemy MCP 服务器、GitHub 上的 Alchemy MCP 源码、Alchemy 开发者文档、Model Context Protocol 及 Alchemy Dashboard。