Evm MCP Server

🚀 以太坊虛擬機（EVM） MCP 服務器文檔

本項目是以太坊虛擬機（EVM） MCP 服務器，提供了對多區塊鏈網絡的支持，具備即時區塊鏈事件監聽、智能合約讀寫操作等豐富功能，可助力開發者高效進行區塊鏈相關開發。

🚀 快速開始

📦 安裝指南

安裝步驟

1. 克隆代碼庫：

git clone git@github.com:your-repository.git mcp-evm-server
cd mcp-evm-server
npm install

2. 啟動服務器：

npm run dev

3. 訪問控制檯： 啟動後，可通過瀏覽器訪問 http://localhost:5000，也可以在終端中使用 curl 命令進行訪問。

配置說明

編輯 src/server/http-server.ts 文件以調整以下配置：

• PORT：服務器端口，默認為 5000
• NETWORKS：支持的區塊鏈網絡，如 Ethereum、Polygon 等
• RPC_ENDPOINTS：第三方 RPC 提供商的 URL
• WALLET_PROVIDERS：錢包提供者的配置

✨ 主要特性

核心組件

1. HTTP 服務器
   • 使用 Server-Sent Events (SSE) 提供即時更新。
   • 支持 RESTful API 和長輪詢。
2. 區塊鏈服務
   • 處理 EVM 相關的區塊鏈操作。
3. 資源系統
   • 暴露區塊鏈數據資源 URI，如鏈信息、區塊、交易等。
4. 工具集
   • 提供區塊鏈分析和交互工具。

核心功能特性

• 支持多區塊鏈網絡。
• 內置錢包和交易服務。
• 即時區塊鏈事件監聽。
• 智能合約讀寫操作。
• 代幣餘額查詢與轉賬。
• NFT 和 ERC1155 代幣支持。

🔧 技術細節

網絡配置

type NetworkConfig = {
  chainId: number;
  name: string;
  rpcUrls: string[];
  blockExplorers?: Record<string, string>;
};

賬戶與交易

• 支持多種錢包提供者（如 MetaMask、WalletConnect）。
• 簽名和廣播交易。
• 交易收據解析。

📚 詳細文檔

安全注意事項

• 私鑰安全：私鑰僅用於交易簽名，服務器不存儲。
• 身份驗證：生產環境建議增加額外認證機制。
• 傳輸加密：使用 HTTPS 部署生產環境。
• 速率限制：防止濫用攻擊。
• 高價值服務：增加確認步驟。

項目結構

mcp-evm-server/
├── src/
│   ├── index.ts                # 標準輸入輸出服務器入口文件
│   ├── server/                 # 服務器相關文件
│   │   ├── http-server.ts      # HTTP 服務器實現，帶 SSE 支持
│   │   └── server.ts           # 通用服務器設置
│   ├── core/
│   │   ├── chains.ts           # 區塊鏈鏈定義與工具
│   │   ├── resources.ts        # MCP 資源實現
│   │   ├── tools.ts            # MCP 工具實現
│   │   ├── prompts.ts          # MCP 提示實現
│   │   └── services/           # 核心區塊鏈服務
│   │       ├── index.ts        # 操作導出
│   │       ├── network.ts      # 網絡配置與管理
│   │       ├── wallet.ts       # 錢包功能實現
│   │       ├── transaction.ts  # 交易處理邏輯
│   │       └── contract.ts     # 智能合約交互
├── package.json                # 項目依賴與腳本
└── README.md                   # 項目文檔

開發指南

1. 開發環境
   • 使用 Node.js 和 TypeScript。
   • 安裝 pnpm 或 npm 進行依賴管理。
2. 調試技巧
   • 啟動開發服務器：npm run dev。
   • 程序運行時目錄：src/。
3. 構建與部署
   • 生產構建：npm run build。
   • 部署到雲服務（如 AWS、Azure）。
4. 貢獻指南
   • 提交代碼前，確保通過單元測試。
   • 遵循代碼風格規範。

附錄

常見問題

1. 如何添加新的區塊鏈網絡？
   • 在 chains.ts 中添加相應配置。
2. 支持哪些錢包提供者？
   • 當前支持 MetaMask、WalletConnect 等主流提供者。
3. 如何處理交易失敗的情況？
   • 通過錯誤處理模塊捕獲並重試。

聯繫方式

• 郵件：contact@example.com
• GitHub：github.com/your-repository

📄 許可證

項目遵循 MIT 許可證，詳情見 LICENSE 文件。

感謝使用以太坊虛擬機（EVM） MCP 服務器！如需更多幫助，請參考文檔或聯繫支持團隊。