Alchemy MCP Server

🚀 Alchemy MCP 服務器

Alchemy MCP 服務器是一個模型上下文協議（MCP）服務器，它能讓 AI 代理以結構化的方式與 Alchemy 的區塊鏈 API 進行交互。藉助該服務器，代理無需編寫代碼就能直接查詢區塊鏈數據，極大地提升了操作的便捷性。

🚀 快速開始

此 MCP 服務器在 AI 代理和 Alchemy 的區塊鏈 API 之間搭建了橋樑，支持代理進行以下操作：

• 查詢代幣價格及價格歷史
• 獲取 NFT 所有者信息
• 查看交易記錄
• 檢查多個區塊鏈網絡中的代幣餘額
• 檢索資產轉移
• 還有更多功能！

快速設置

若要快速設置 MCP 服務器，請在您的 MCP 配置文件（通常位於 Claude Desktop 或 Cursor 設置中）使用以下配置：

{
  "mcpServers": {
    "alchemy": {
      "command": "npx",
      "args": [
        "-y",
        "@alchemy/mcp-server"
      ],
      "env": {
        "ALCHEMY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

該配置可讓您無需手動克隆倉庫就能使用服務器。

✨ 主要特性

您可以提示 AI 代理使用以下方法：

代幣價格方法

1. fetchTokenPriceBySymbol
   • 功能：根據符號獲取當前代幣價格數據
   • 示例："ETH 和 BTC 當前價格是多少？"
2. fetchTokenPriceByAddress
   • 功能：根據合約地址獲取當前代幣價格數據
   • 示例："0x1234...5678 地址的 ETH 價格是多少？"
3. fetchTokenPriceHistoryBySymbol
   • 功能：獲取代幣的歷史價格數據
   • 示例："顯示 BTC 在 2023 年 1 月 1 日到 2 月 1 日之間的每日價格歷史"

多鏈代幣方法

4. fetchTokensOwnedByMultichainAddresses
   • 功能：獲取多個網絡地址的代幣餘額
   • 示例："0xabc...123 在 Ethereum 和 Base 網絡上持有哪些代幣？"

交易記錄方法

5. fetchMultichainWalletAddressTransactionHistory
   • 功能：獲取多鏈錢包地址的交易歷史
   • 示例："顯示 0xdef...456 地址在 Ethereum 網絡上的近期交易記錄"
6. fetchTransfers
   • 功能：獲取地址的代幣轉移數據
   • 示例："顯示所有 ERC - 20 轉移到或從 0xghi...789 的記錄"

NFT 方法

7. fetchNftsOwnedByMultichainAddresses
   • 功能：獲取多個地址的所有 NFT
   • 示例："0xjkl...012 地址擁有哪些 NFT？"
8. fetchNftContractDataByMultichainAddress
   • 功能：獲取多個地址的 NFT 合約數據
   • 示例："0xmno...345 地址參與了哪些 NFT 收藏系列？"

📦 安裝指南

安裝

1. 克隆倉庫

git clone https://github.com/alchemyplatform/alchemy-mcp.git
cd alchemy-mcp

2. 安裝依賴項

npm install

運行測試

npm test

構建項目

npm run build

本地開發服務器啟動

npm start

💻 使用示例

基礎用法

以下是一些使用示例：

1. 查詢代幣價格：

curl -X POST http://localhost:3000/api/v1/queryTokenPrice \
  -H "Content-Type: application/json" \
  -d '{"symbol": "ETH"}'

2. 獲取 NFT 信息：

curl -X POST http://localhost:3000/api/v1/getNfts \
  -H "Content-Type: application/json" \
  -d '{"address": "0xjkl...012"}'

📚 詳細文檔

完整的 API 文檔請參考 API DOCS。

📄 許可證

該項目受 MIT License 的保護。

通過以上內容，您可以輕鬆開始使用 Alchemy MCP 服務器與區塊鏈進行交互。

開源貢獻

我們歡迎社區的貢獻！請參考 CONTRIBUTING.md 瞭解如何參與。