Foundry MCP

🚀 🧠 Foundry MCP 項目

Foundry MCP 項目是一個模型上下文協議（MCP）服務器，專為與 Foundry 工具交互而設計。它提供了一系列實用工具，可用於管理 Foundry 項目、運行測試、構建合約等，極大地提升了項目開發與管理的效率。

🚀 快速開始

本項目是一個模型上下文協議（MCP）服務器，與 Foundry 工具交互，提供管理項目、運行測試、構建合約等功能。克隆倉庫並確保 Foundry 工具安裝後，即可啟動 MCP 服務器開展工作。

✨ 主要特性

• 創建 Foundry 項目：可輕鬆初始化新的 Foundry 項目。
• 構建合約：能編譯 Solidity 合約，且帶有多種選項。
• 運行測試：可執行 Foundry 項目的測試，還能進行詳細配置。
• 檢查合約：可獲取 ABI、字節碼和其他元數據。
• 運行腳本：能夠執行 Solidity 腳本。
• 啟動本地節點：可使用 Anvil 或 Chisel 啟動本地 Ethereum 節點。
• 高級 Cast 命令：可使用 cast 執行 Ethereum 相關命令。

📦 安裝指南

1. 克隆倉庫：

   git clone <repository-url>
   

2. 確保 Foundry 工具（forge、cast、anvil 等）已安裝，並添加到 PATH 中。

💻 使用示例

基礎用法

要啟動 MCP 服務器：

python src/eth_wh_mcp/main.py

高級用法

MCP 服務器提供了豐富的工具，以下是部分工具的使用說明：

• create_project：初始化一個新的 Foundry 項目。
• build_project：構建當前的 Foundry 項目。
• test_project：運行 Foundry 項目的測試。
• clone_contract：從 Etherscan 克隆合約。
• run_script：執行 Solidity 腳本。
• run_cast_command：運行 cast 命令。
• start_anvil_with_options：使用選項啟動 Anvil 本地 Ethereum 節點。
• start_chisel_with_options：使用選項啟動 Chisel Solidity REPL。
• inspect_contract：檢查合約元數據。
• snapshot_project：創建 gas 使用快照。
• coverage_project：顯示測試覆蓋情況。

📚 詳細文檔

MCP Python SDK

參閱 LLM/python-mcp-sdk.md 文件，獲取詳細的 MCP Python SDK 使用說明，包括服務器構建、工具使用、提示和上下文處理。

🔧 技術細節

項目結構

pyproject.toml       # 項目配置文件
README.md            # 項目文檔
uv.lock              # 依賴鎖定文件
LLM/                 # 文檔和 SDK 使用說明
src/eth_wh_mcp/      # MCP 服務器的源代碼

本地調試

以開發模式運行 MCP 服務器：

mcp dev src/eth_wh_mcp/main.py --with-editable .

運行時執行

要執行服務器：

python src/eth_wh_mcp/main.py

📄 許可證

本項目 licensed under the MIT License。有關詳細信息，請參閱 LICENSE 文件。