Foundry项目管理工具

一个用于管理Foundry项目的工具,提供项目初始化、合约编译、测试运行、脚本执行等功能,适用于以太坊智能合约开发。

  • by lhemerly
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 lhemerly/foundry-mcp

使用说明

🧠 铸造MCP项目

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


📂 项目结构

pyproject.toml       # Project configuration file
README.md            # Project documentation
uv.lock              # Dependency lock file
LLM/                 # Documentation and SDK usage
src/eth_wh_mcp/      # Source code for the MCP server

🚀 特性

  • 创建铸造项目:初始化新的Foundry项目。
  • 构建合同:编制具有各种选项的Solidity合同。
  • 运行测试:执行具有详细配置的测试。
  • 检查合同:检索ABI、字节码和其他元数据。
  • 运行脚本:执行Solidity脚本。
  • 启动本地节点:启动Anvil或Chisel用于本地以太坊开发。
  • 高级强制转换命令:使用以下命令执行以太坊相关命令 cast.

🛠️ 安装

通过Smithery安装

通过以下方式自动安装适用于Claude Desktop的Foundry MCP服务器 史密瑟里:

npx -y @smithery/cli install @lhemerly/foundry-mcp --client claude

手动安装

  1. 克隆存储库:

    git clone <repository-url>
    
  2. 确保铸造工具(forge, cast, anvil等)已安装并可在您的PATH中使用。


🏗️ 用法

运行MCP服务器

要启动MCP服务器,请执行以下操作:

python src/eth_wh_mcp/main.py

可用工具

MCP服务器中提供以下工具:

  • 创建项目:初始化新的Foundry项目。
  • 建筑工程:构建当前的Foundry项目。
  • 测试工程:在Foundry项目中运行测试。
  • 克隆合同:从Etherscan克隆合约。
  • run_script:执行Solidity脚本。
  • run_cast_command:运行a cast 命令。
  • start_anvil_with_options:启动Anvil本地以太坊节点。
  • start_chiselwith_options:启动凿子坚固性REPL。
  • 检查合同:检查合同元数据。
  • 快照_项目:创建气体使用快照。
  • 覆盖范围_项目:显示测试覆盖率。

📖 文档

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