炼金MCP服务器
一个模型上下文协议（MCP）服务器，使AI代理能够以结构化的方式与Alchemy的区块链API进行交互。这允许代理直接查询区块链数据，而无需编写任何代码。
远程MCP服务器（推荐）
最快的入门方法是连接到托管的远程服务器 https://mcp.alchemy.com/mcp。它通过OAuth进行身份验证——只需在系统提示时使用您的Alchemy帐户登录即可。不需要API密钥或本地安装。
完整文档： alchemy.com/docs/alchemy-mcp-server
注： 托管服务器位于 mcp.alchemy.com 这个开源仓库是单独维护的，可能不同步。| 客户端 | 安装程序 |
|---|---|
| 克劳德代码 | claude mcp add alchemy --transport http https://mcp.alchemy.com/mcp |
| 法典 | codex mcp add alchemy --url https://mcp.alchemy.com/mcp |
| 光标 | 添加到 ~/.cursor/mcp.json 或 .cursor/mcp.json --请参阅下面的JSON配置 |
| 帆板运动 | 添加到 ~/.codeium/windsurf/mcp_config.json --请参阅下面的JSON配置 |
| VS代码副本 | 添加到 .vscode/mcp.json --请参阅下面的JSON配置 |
| 克劳德桌面版 | 添加到 claude_desktop_config.json --请参阅下面的JSON配置 |
| 克莱恩 | 打开 Cline: MCP Servers 从VS Code命令面板中--请参阅下面的JSON配置 |
JSON config for Cursor / Windsurf / Claude Desktop / Cline
{
"mcpServers": {
"alchemy": {
"type": "streamable-http",
"url": "https://mcp.alchemy.com/mcp"
}
}
}JSON config for VS Code Copilot
{
"servers": {
"alchemy": {
"type": "http",
"url": "https://mcp.alchemy.com/mcp"
}
}
}对于任何其他兼容MCP的客户端，请将其指向 https://mcp.alchemy.com/mcp 使用流式HTTP传输。
本地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
⚠️ 重要：The sendTransaction 和 swap 如果没有正确配置的钱包代理服务器，方法将无法运行。这些方法需要外部钱包基础设施来处理签名和广播交易。
可用方法
您可以提示您的AI代理使用以下方法：
代币价格方法
- fetchTokenPriceBySymbol
- 按符号获取代币的当前价格数据 - 示例：“ETH和BTC的当前价格是多少？”
- fetchTokenPriceByAddress
- 按合约地址获取代币的当前价格数据 - 示例：“以太坊主网地址0x1234…5678处的代币价格是多少？”
- fetchToken价格历史BySymbol
- 获取具有特定日期范围的代币的历史价格数据 - 示例：“显示2023年1月1日至2月1日的BTC价格历史记录，包括每日间隔”
- fetchToken价格历史按时间帧
- 使用灵活的时间框架或自然语言获取历史价格数据 - 示例：“显示上周的ETH价格”或“获取过去30天的BTC价格”
多链代币方法
- fetch多线程地址拥有的令牌
- 获取跨多个网络的地址的令牌余额 - 示例：“0xabc…123在以太坊和Base上持有哪些代币？”
交易历史记录方法
- fetchAddress事务历史记录
- 获取跨多个网络的地址的事务历史记录 - 示例：“显示以太坊上0xdef…456钱包的最近交易”
- fetch传输
- 使用高级筛选选项获取详细的资产转移数据 - 示例：“显示所有与0xghi…789之间的ERC-20传输”
NFT方法
- fetchNftsowned by Multichain地址
- 获取垃圾邮件过滤地址所拥有的所有NFT - 示例：“0xjkl…012拥有什么NFT？”
- fetchNftContractDataBy多链地址
- 获取地址的NFT合约数据 - 示例：“0xmno…345有来自哪些NFT集合的令牌？”
交易方式
- sendTransaction
- 通过智能合约账户发送交易 - ⚠️ 重要：需要配置的钱包代理服务器 AGENT_WALLET_SERVER 环境变量 - 示例：“向0xpqr发送0.1 ETH…678”
交换方法
- 交换
- 通过DEX协议执行代币交换（Uniswap） - ⚠️ 重要：需要配置的钱包代理服务器 AGENT_WALLET_SERVER 环境变量 - 示例：“用100美元兑换ETH”
本地开发和开源贡献
安装
- 克隆仓库
git clone https://github.com/alchemyplatform/alchemy-mcp.git
cd alchemy-mcp- 安装依赖项
pnpm install发展
pnpm watch生产环境构建
pnpm build使用MCP检查器进行调试
MCP检查器通过提供一个可视化界面来测试您的方法，从而帮助您调试MCP服务器：
pnpm inspector这将启动您可以在浏览器中访问的MCP检查器。它允许您：
- 查看所有可用方法
- 不同参数的测试方法
- 查看响应数据
- 调试MCP服务器的问题
贡献
欢迎拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。
许可证
此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的更多信息，请参阅：