Foundry MCP Server

🚀 Foundry MCP Server

Foundry MCP Server 是一個簡單、輕量級且快速的 MCP（模型上下文協議）服務器，它藉助 Foundry 工具鏈（Forge、Cast 和 Anvil）提供 Solidity 開發能力。

🚀 快速開始

本服務器旨在作為 MCP 客戶端的 MCP 工具提供者。連接到客戶端後，它能讓客戶端（如 Claude 桌面版、Cursor 等）直接執行 Solidity 和鏈上操作。

要求

• Node.js v18+
• Foundry 工具鏈（Forge、Cast、Anvil）

手動設置

1. 確保系統已安裝 Foundry 工具（Forge、Cast、Anvil）：

   curl -L https://foundry.paradigm.xyz | bash
   foundryup
   

2. 克隆並構建服務器。

   bun i && bun build ./src/index.ts --outdir ./dist --target node
   

3. 更新客戶端配置（例如：Claude 桌面版）：

 "mcpServers": {
    "foundry": {
      "command": "node",
      "args": [
        "path/to/foundry-mcp-server/dist/index.js"
      ],
      "env" :{
        "PRIVATE_KEY": "0x1234",
      }
    }
 }

⚠️ 重要提示 PRIVATE_KEY 是可選的

使用 NPM 包設置

• 即將推出

配置

服務器支持以下環境變量：

• RPC_URL：未指定時使用的默認 RPC URL（可選）
• PRIVATE_KEY：用於交易的私鑰（可選）

⚠️ 重要提示 不要添加帶有主網資金的密鑰。即使代碼安全地使用它，但大語言模型可能會產生錯誤輸出併發送惡意交易。僅將其用於測試/開發目的，切勿信任大語言模型！

工作區

服務器在 ~/.mcp-foundry-workspace 維護一個持久的 Forge 工作區，用於存放所有 Solidity 文件、腳本和依賴項。

✨ 主要特性

網絡交互

• 啟動和管理本地 Anvil 實例
• 連接到任何遠程網絡（只需指定 RPC）
• 獲取網絡/鏈信息

合約交互

• 調用合約函數（只讀）
• 向合約發送交易（如果配置了 PRIVATE_KEY）
• 獲取交易收據
• 讀取合約存儲
• 分析交易跟蹤
• 從區塊瀏覽器檢索合約 ABI 和源代碼

Solidity 開發

• 維護專用的 Forge 工作區
• 創建和編輯 Solidity 文件
• 安裝依賴項
• 運行 Forge 腳本
• 部署合約

實用功能

• 計算合約地址
• 檢查合約字節碼大小
• 估算 gas 成本
• 進行單位轉換（十六進制到十進制等）
• 生成錢包
• 獲取事件日誌
• 查找函數和事件簽名

💻 使用示例

在 Claude 桌面應用中的使用 🎯

安裝完成並配置好 Claude 桌面應用後，必須完全關閉並重新打開 Claude 桌面應用才能看到 tavily-mcp 服務器。你應該會在應用左下角看到一個錘子圖標，表示有可用的 MCP 工具，點擊錘子圖標可查看可用工具的更多詳細信息。

現在 Claude 可以完全訪問 Foundry MCP 服務器。如果你將以下示例插入 Claude 桌面應用，應該能看到 Foundry MCP 服務器工具的實際運行情況。

示例

1. 交易分析：

Can you analyze the transaction and explain what it does? 
https://etherscan.io/tx/0xcb73ad3116f19358e2e649d4dc801b7ae0590a47b8bb2e57a8e98b6daa5fb14b

2. 查詢餘額：

Query the mainnet ETH and USDT balances for the wallet 0x195F46025a6926968a1b3275822096eB12D97E70.

3. 發送交易：

Transfer 0.5 USDC to 0x195F46025a6926968a1b3275822096eB12D97E70 on Mainnet. 

4. 部署合約/運行腳本：

Deploy a mock ERC20 contract to a local anvil instance and name it "Fire Coin".

📚 詳細文檔

工具

Anvil

• anvil_start：啟動新的 Anvil 實例
• anvil_stop：停止正在運行的 Anvil 實例
• anvil_status：檢查 Anvil 是否正在運行並獲取其狀態

Cast

• cast_call：調用合約函數（只讀）
• cast_send：向合約函數發送交易
• cast_balance：檢查地址的 ETH 餘額
• cast_receipt：獲取交易收據
• cast_storage：讀取特定插槽的合約存儲
• cast_run：在本地環境中運行已發佈的交易
• cast_logs：按簽名或主題獲取日誌
• cast_sig：獲取函數或事件簽名的選擇器
• cast_4byte：從 4byte 目錄中查找函數或事件簽名
• cast_chain：獲取當前鏈的信息

Forge

• forge_script：從工作區運行 Forge 腳本
• install_dependency：為 Forge 工作區安裝依賴項

文件管理

• create_solidity_file：在工作區創建或更新 Solidity 文件
• read_file：從工作區讀取文件內容
• list_files：列出工作區中的文件

實用工具

• convert_eth_units：在 EVM 單位（wei、gwei、十六進制）之間進行轉換
• compute_address：計算將要部署的合約地址
• contract_size：獲取已部署合約的字節碼大小
• estimate_gas：估算交易的 gas 成本

📄 許可證

致謝 ✨

• Model Context Protocol 提供 MCP 規範
• Anthropic 提供 Claude 桌面版

免責聲明

本軟件按“原樣”提供。對於軟件的安全性或正確性，未作出任何明示或暗示的保證、陳述或擔保。軟件未經審計，因此不能保證其按預期工作，用戶可能會遇到延遲、故障、錯誤、遺漏、傳輸信息丟失或資金損失等情況。創建者對上述情況不承擔任何責任。用戶應謹慎使用，並自擔風險。