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 文件。