🧠 Foundry MCP 项目

这个项目是一个模型上下文协议（MCP）服务器，设计用于与Foundry工具交互。它提供了一系列工具和实用程序，用于管理Foundry项目、运行测试、构建合约等。

📂 项目结构

pyproject.toml       # 项目配置文件
README.md            # 项目文档
uv.lock              # 依赖锁定文件
LLM/                 # 文档和SDK使用说明
src/eth_wh_mcp/      # 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服务器

要启动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使用说明，包括服务器构建、工具使用、提示和上下文处理。

🧪 开发

本地调试

以开发模式运行MCP服务器：

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

运行时执行

要执行服务器：

python src/eth_wh_mcp/main.py

📜 许可证

本项目 licensed under the MIT License。有关详细信息，请参阅LICENSE文件。