🚀 🧠 Foundry MCP 项目
Foundry MCP 项目是一个模型上下文协议（MCP）服务器，专为与 Foundry 工具交互而设计。它提供了一系列实用工具，可用于管理 Foundry 项目、运行测试、构建合约等，极大地提升了项目开发与管理的效率。
🚀 快速开始
本项目是一个模型上下文协议（MCP）服务器，与 Foundry 工具交互，提供管理项目、运行测试、构建合约等功能。克隆仓库并确保 Foundry 工具安装后，即可启动 MCP 服务器开展工作。
✨ 主要特性
- 创建 Foundry 项目：可轻松初始化新的 Foundry 项目。
- 构建合约：能编译 Solidity 合约，且带有多种选项。
- 运行测试：可执行 Foundry 项目的测试，还能进行详细配置。
- 检查合约：可获取 ABI、字节码和其他元数据。
- 运行脚本：能够执行 Solidity 脚本。
- 启动本地节点：可使用 Anvil 或 Chisel 启动本地 Ethereum 节点。
- 高级 Cast 命令：可使用
cast执行 Ethereum 相关命令。
📦 安装指南
- 克隆仓库：
git clone - 确保 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 文件。