内容
# 🧠 Foundry MCP 项目
[](https://smithery.ai/server/@lhemerly/foundry-mcp)
该项目是一个模型上下文协议（Model Context Protocol，MCP）服务器，旨在与 Foundry 工具进行交互。它提供了一套工具和实用程序来管理 Foundry 项目、运行测试、构建合约等。
---
## 📂 项目结构
```
pyproject.toml # 项目配置文件
README.md # 项目文档
uv.lock # 依赖锁定文件
LLM/ # 文档和 SDK 使用
src/eth_wh_mcp/ # MCP 服务器的源代码
```
---
## 🚀 特性
- **创建 Foundry 项目**：初始化新的 Foundry 项目。
- **构建合约**：使用各种选项编译 Solidity 合约。
- **运行测试**：以详细配置执行测试。
- **检查合约**：检索 ABI、字节码和其他元数据。
- **运行脚本**：执行 Solidity 脚本。
- **启动本地节点**：启动 Anvil 或 Chisel 进行本地以太坊开发。
- **高级 Cast 命令**：使用 `cast` 执行与以太坊相关的命令。
---
## 🛠️ 安装
### 通过 Smithery 安装
要通过 [Smithery](https://smithery.ai/server/@lhemerly/foundry-mcp) 自动安装 Foundry MCP Server for Claude Desktop：
```bash
npx -y @smithery/cli install @lhemerly/foundry-mcp --client claude
```
### 手动安装
1. 克隆仓库：
```bash
git clone <repository-url>
```
2. 确保 Foundry 工具（`forge`、`cast`、`anvil` 等）已安装并在你的 PATH 中可用。
---
## 🏗️ 使用
### 运行 MCP 服务器
要启动 MCP 服务器：
```bash
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 本地以太坊节点。
- **start_chisel_with_options**：启动 Chisel Solidity REPL。
- **inspect_contract**：检查合约元数据。
- **snapshot_project**：创建气体使用快照。
- **coverage_project**：显示测试覆盖率。
---
## 📖 文档
### MCP Python SDK
请参考 [LLM/python-mcp-sdk.md](LLM/python-mcp-sdk.md) 文件，获取 MCP Python SDK 的详细使用说明，包括服务器构建、工具、提示和上下文处理。
---
## 🧪 开发
### 本地调试
在开发模式下运行 MCP 服务器：
```bash
mcp dev src/eth_wh_mcp/main.py --with-editable .
```
### 运行时执行
要执行服务器：
```bash
python src/eth_wh_mcp/main.py
```
---
## 📜 许可证
该项目根据 MIT 许可证授权。有关详细信息，请参见 LICENSE 文件。
MCP 市场