🧠 Foundry MCP 项目

本项目是一个模型上下文协议 (MCP) 服务器，旨在与 Foundry 工具进行交互。它提供了一套工具和实用程序来管理 Foundry 项目、运行测试、构建合约等等。

---

📂 项目结构

pyproject.toml       # 项目配置文件
README.md            # 项目文档
uv.lock              # 依赖锁定文件
LLM/                 # 文档和 SDK 用法
src/eth_wh_mcp/      # MCP 服务器的源代码

---

🚀 功能

• 创建 Foundry 项目: 初始化新的 Foundry 项目。
• 构建合约: 使用各种选项编译 Solidity 合约。
• 运行测试: 执行带有详细配置的测试。
• 检查合约: 检索 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

---

📜 许可证

本项目根据 MIT 许可证获得许可。 有关详细信息，请参见 LICENSE 文件。