MCP Ethers Server

🚀 MCP 協議實現

MCP 協議實現是一款強大的工具，支持 ERC20、ERC721 和 ERC1155 代幣標準。它集成了錢包功能、代幣操作和智能合約交互，極大地便利了區塊鏈開發。

🚀 快速開始

MCP 協議實現為區塊鏈開發者提供了便捷的功能，以下是使用前的準備步驟。

環境變量設置

將以下內容添加到您的項目根目錄的 .env 文件中：

ALCHEMY_API_KEY=your_alchemy_api_key
INFURA_PROJECT_ID=your_infura_project_id

服務啟動

在終端中運行以下命令啟動 MCP 服務器：

npm run start

📦 安裝指南

網絡配置

將您的網絡配置添加到 config/networks.json 文件中，例如：

{
  "mainnet": {
    "name": "Ethereum Main Network",
    "chainId": 1,
    "providerType": "ALCHEMY"
  },
  "ropsten": {
    "name": "Ethereum Test Network - Ropsten",
    "chainId": 3,
    "providerType": "INFURA"
  }
}

✨ 主要特性

錢包功能

• 錢包創建：生成新的 Ethereum 錢包地址。
• 私鑰管理：支持將私鑰保存到環境變量或內存中。
• 餘額查詢：獲取指定地址的 ETH 和代幣餘額。

代幣操作

• ERC20：實現代幣的基本功能，如轉賬、批准等。
• ERC721：支持 NFT 的鑄造、轉移和所有權查詢。
• ERC1155：實現批量代幣操作，包括單個和多個代幣的轉移。

智能合約交互

• 方法調用：通過ABI接口調用智能合約的方法。
• 事件監聽：即時監控區塊鏈上的事件。
• 交易處理：發送和確認交易請求。

緩存機制

系統為以下操作啟用了緩存功能：

• 代幣信息（名稱、符號、小數位）
• 代幣餘額
• 合約方法調用

默認情況下，緩存的有效期為 1 小時。您可以在 config/cache.json 中自定義緩存策略。

速率限制

為了防止濫用和確保系統的穩定性，服務器對以下操作實施了速率限制：

• 寫入操作（轉賬、授權）
• 錢包生成
• 合約交互

錯誤處理

系統提供詳細的錯誤信息和狀態碼，便於調試和問題排查。所有錯誤都經過安全處理，防止敏感數據洩露。

📚 詳細文檔

開發指南

構建項目

運行以下命令進行構建：

npm run build

測試套件

使用 Bun 運行所有測試（推薦）

# 在終端啟動 Hardhat 節點
npx hardhat node

# 運行所有測試用例
bun test

僅運行 MCP 客戶端測試

bun run test:client:mcp

安全注意事項

⚠️ 重要提示

• 錢包功能默認不將私鑰保存到文件系統。建議在處理敏感操作時謹慎使用 saveToEnv 選項。
• 確保 .env 文件的安全性，避免洩露 API 密鑰。

📄 許可證

MCP 協議實現遵循 MIT 許可證，允許自由使用、修改和分發。