Foundry MCP

This is a Model Context Protocol (MCP) server project designed for Foundry tools, providing development functions such as creating projects, building contracts, and running tests.

Developer tools Finance #Ethereum development #Smart contracts #Testing tools .Python

rating : 2 points

downloads : 13

update time : 2025-04-28

What is Foundry MCP Server?

The Foundry MCP Server is a bridge that connects users to Foundry's powerful blockchain development tools through a simple interface. It allows you to manage smart contracts, run tests, and interact with Ethereum networks without needing deep technical knowledge of the underlying commands.

How to use Foundry MCP Server?

Simply start the server and use the provided tools through a web interface or API calls. The server handles all the complex Foundry commands in the background.

Use Cases

Ideal for blockchain developers who want to simplify their workflow, educators teaching smart contract development, or teams collaborating on Ethereum projects.

Key Features

Project ManagementCreate and manage complete Foundry projects with simple commands

Smart Contract ToolsBuild, test, and inspect smart contracts with easy-to-use tools

Local Blockchain NetworksStart and manage local Ethereum networks for development and testing

Etherscan IntegrationClone and analyze contracts directly from Etherscan

Pros and Cons

Advantages

Simplifies complex blockchain development tasks

Provides a unified interface for all Foundry tools

Reduces the learning curve for new blockchain developers

Enables easy automation of development workflows

Limitations

Requires Foundry tools to be installed on the system

Limited to features available in Foundry

Performance depends on underlying system resources

Getting Started

Install Prerequisites

Ensure Foundry tools (forge, cast, anvil) are installed on your system

Start the MCP Server

Run the server to begin accepting commands

Use the Tools

Access the tools through the web interface or by making API calls

Example Use Cases

Creating a New ProjectStart developing a new smart contract from scratch

Testing a ContractVerify your smart contract works as intended

Inspecting a ContractGet the ABI and bytecode of a deployed contract

Frequently Asked Questions

Do I need to know Solidity to use this?

Can I use this for production deployments?

What if I get an error about missing Foundry tools?

Additional Resources

Foundry Documentation

Official Foundry toolchain documentation

Solidity Documentation

Learn Solidity smart contract language

MCP SDK Guide

Advanced usage of the MCP Python SDK

🚀 Foundry MCP Project

This project is a Model Context Protocol (MCP) server designed to interact with Foundry tools. It offers a set of tools and utilities for managing Foundry projects, running tests, building contracts, and more.

📂 Project Structure

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

✨ Features

Create Foundry Project: Initialize a new Foundry project.
Build Contracts: Compile Solidity contracts with various options.
Run Tests: Execute tests for Foundry projects with detailed configurations.
Inspect Contracts: Retrieve ABI, bytecode, and other metadata.
Run Scripts: Execute Solidity scripts.
Start Local Node: Launch a local Ethereum node using Anvil or Chisel.
Advanced Cast Commands: Execute Ethereum-related commands using cast.

📦 Installation

Clone the repository:
```
git clone <repository-url>
```
Ensure that Foundry tools (forge, cast, anvil, etc.) are installed and added to the PATH.

💻 Usage Examples

Basic Usage

To start the MCP server:

python src/eth_wh_mcp/main.py

Available Tools

The MCP server provides the following tools:

create_project: Initialize a new Foundry project.
build_project: Build the current Foundry project.
test_project: Run tests for the Foundry project.
clone_contract: Clone a contract from Etherscan.
run_script: Execute a Solidity script.
run_cast_command: Run a cast command.
start_anvil_with_options: Start an Anvil local Ethereum node with options.
start_chisel_with_options: Start a Chisel Solidity REPL with options.
inspect_contract: Inspect contract metadata.
snapshot_project: Create a gas usage snapshot.
coverage_project: Display test coverage.

📚 Documentation

MCP Python SDK

Refer to the LLM/python-mcp-sdk.md file for detailed instructions on using the MCP Python SDK, including server construction, tool usage, prompts, and context handling.

🔧 Technical Details

Local Debugging

Run the MCP server in development mode:

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

Runtime Execution

To execute the server:

python src/eth_wh_mcp/main.py

📄 License

This project is licensed under the MIT License. For more details, please refer to the LICENSE file.

Featured MCP Services

Gitlab MCP Server

Certified

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

TypeScript

1.7K

5 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

564

5 points

Gmail MCP Server

A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.

The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.

Python

753

4.8 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご