大模型应用
在 AI 客户端中通过 Alchemy MCP…
当 MCP 已接入 AI 客户端且本地未安装 Alchemy CLI 时,用托管 Alchemy MCP 服务器做实时链上查询、交易模拟、NFT/组合查询和 Alchemy 应用管理。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
在 AI 客户端中通过 Alchemy 特定
解决思路
- 确认使用条件:用户需要实时 agent 工作(实时查询、分析、管理或本机自动化),且 MCP 兼容客户端已接入 https://mcp.alchemy.com/mcp 或用户愿意添加,并且本地未安装 Alchemy CLI(@alchemy/cli)。
- 若本地已安装 CLI 或 CLI 与 MCP 都可用,改用 alchemy-cli 技能;若两者都不可用,先执行 npm i -g @alchemy/cli 再使用 alchemy-cli。
- 若在构建带 Alchemy API key 的生产应用代码,改用 alchemy-api 技能;若无 API key 或需要自主付费/x402/MPP,改用 agentic-gateway 技能。
- 连接 Claude Code:最快方式是安装官方 Alchemy Claude Plugin,执行 /plugin marketplace add alchemyplatform/alchemy-claude-plugin 和 /plugin install alchemy@alchemy,然后运行 /alchemy:setup 选择应用,首次调用 Alchemy 工具时自动打开 OAuth。
- 仅接入 MCP 服务器(不用插件)时,在 Claude Code 执行 claude mcp add alchemy --transport http https://mcp.alchemy.com/mcp,重启后运行 /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:在 macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %APPDATA%\Claude\claude_desktop_config.json 中添加 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;服务器支持 OAuth 2.1 with PKCE,客户端自动处理授权流程。
- 连接并 OAuth 登录后执行引导流程:先调用 list_apps 查看 Alchemy 应用,再调用 select_app 并传入 app ID(会缓存服务器用于 RPC 和 Data 工具的 API key,任何 RPC 或 Data 工具调用前必须执行),然后调用 159 个工具中的任意一个(如 getTokenPricesBySymbol、getNFTsForOwner、simulateAssetChanges、solana_getBalance)。
- 若需要先创建应用,调用 create_app(name="My App", networks=["eth-mainnet", "base-mainnet"]),然后对新应用调用 select_app。
- 使用 Admin 类 8 个工具管理账号与应用:ping(健康检查)、list_apps、get_app、select_app、create_app、update_app、list_chains、update_allowlist(更新网络、地址、来源、IP 白名单)。
- 使用 RPC 类 123 个工具做链上 JSON-RPC 调用,涵盖标准 EVM RPC(31 个,如 ethBlockNumber、ethGetBalance、ethCall、ethGetLogs、ethCallBundle)、Token API(3 个:getTokenBalances、getTokenMetadata、getTokenAllowance)、Transfers & Receipts(2 个:getAssetTransfers、getTransactionReceipts)、Transaction Simulation(5 个:simulateAssetChanges、simulateExecution、simulateUserOperationAssetChanges)、Trace API(6 个:traceCall、traceTransaction、traceBlock、traceFilter)、Debug API(6 个:debugTraceTransaction、debugTraceCall、debugTraceBlockByNumber)、ERC-4337 Account Abstraction(7 个:estimateUserOperationGas、getUserOperationReceipt、requestGasAndPaymasterAndData)、Solana Standard RPC(50 个: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)、Portfolio 多链(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;单链 NFT 用 getNFTsForOwner;多链 NFT 用 getNFTsByAddress;NFT 元数据用 getNFTMetadata;地板价用 getFloorPrice;现货价格用 getTokenPricesBySymbol(如 ["ETH","USDC"]);历史价格用 getHistoricalTokenPrices;多链组合用 getTokenBalancesByAddress(含 USD 价值);Solana 余额用 solana_getBalance(lamports);Solana 代币账户用 solana_getTokenAccountsByOwner(SPL 代币);压缩 NFT 查询用 solana_getAsset(DAS 标准);某地址的压缩 NFT 用 solana_getAssetsByOwner;Solana 优先费估算用 solana_getPriorityFeeEstimate;用户操作回执用 getUserOperationReceipt。
- 遵守操作规则:任何 RPC 或 Data 工具前必须先调用 select_app;使用 list_chains 返回的规范链 slug(如 eth-mainnet、base-mainnet、solana-mainnet),猜错时工具错误信息会给出指引;不要在 agent 内用原始 curl/HTTP 绕过 MCP 服务器(那属于 alchemy-api 的 API-key 路径);不要用 MCP 工具生成生产应用代码,用户要交付代码时转交 alchemy-api(带 API key)或 agentic-gateway(不带)。
- 支持 100+ 链,包括 Ethereum、Base、Polygon、Arbitrum、Optimism、BNB、Solana、Starknet、zkSync、Scroll、Linea、Mantle、Blast、World Chain 等,用 list_chains 获取完整列表。
- 排障:出现 "No app selected" 时用目标 app ID 调用 select_app,没有应用则先 create_app;OAuth 流程未打开时重启 MCP 客户端,Claude Code 中运行 /mcp 并选择 alchemy 手动触发登录;工具未找到时注意部分工具有命名空间(如 Solana 的 solana_*),用 list_chains 确认链 slug 并核对工具目录中的准确名称;遇到速率限制/计算单元问题时,MCP 服务器继承所选应用的速率限制,在 Alchemy dashboard 查看用量。
适用边界 · 注意事项
- 本地已安装 @alchemy/cli,或 CLI 与 MCP 都可用时(应优先 alchemy-cli)。
- 需要编写会交付到生产环境的应用代码时(应改用 alchemy-api 或 agentic-gateway)。
- 没有 MCP 兼容客户端且用户不愿添加,或既无 CLI 也无 MCP 可用时(应先安装 alchemy-cli)。