Foundry MCP Project

🧠 Foundry MCP Project

This project is a Model Context Protocol (MCP) server designed to interact with Foundry tools. It provides a set of tools and utilities to manage Foundry projects, run tests, build contracts, and more.

📂 Project Structure

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

🚀 Features

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

🛠️ Installation

Installing via Smithery

To install Foundry MCP Server for Claude Desktop automatically via Smithery:

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

Manual Installation

Clone the repository:
git clone <repository-url>
Ensure Foundry tools (forge, cast, anvil, etc.) are installed and available in your PATH.

🏗️ Usage

Running the MCP Server

To start the MCP server:

python src/eth_wh_mcp/main.py

Available Tools

The following tools are available in the MCP server:

create_project: Initialize a new Foundry project.
build_project: Build the current Foundry project.
test_project: Run tests in 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 the Anvil local Ethereum node.
start_chisel_with_options: Start the Chisel Solidity REPL.
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 usage of the MCP Python SDK, including server construction, tools, prompts, and context handling.

🧪 Development

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. See the LICENSE file for details.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that enables interaction with Foundry tools through natural language, allowing users to create projects, build contracts, run tests, and manage Ethereum development environments.

Related MCP Servers

Node Omnibus MCP Server
bsmi021
A
security
A
license
A
quality
A comprehensive Model Context Protocol server that provides advanced Node.js development tooling for automating project creation, component generation, package management, and documentation with AI-powered assistance.
Last updated -
7
4
JavaScript
MIT License
MCP Ethers Wallet
crazyrabbitLTC
A
security
A
license
A
quality
A Model Context Protocol server that gives LLMs the ability to interact with Ethereum networks, manage wallets, query blockchain data, and execute smart contract operations through a standardized interface.
Last updated -
31
11
8
TypeScript
MIT License
EVM MCP Server
mcpdotdirect
A
security
A
license
A
quality
A Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, providing services like token transfers, contract interactions, and ENS resolution through a unified interface.
Last updated -
28
376
299
TypeScript
MIT License
Docs MCP Server
buger
A
security
A
license
A
quality
A flexible Model Context Protocol server that makes documentation or codebases searchable by AI assistants, allowing users to chat with code or docs by simply pointing to a git repository or folder.
Last updated -
1
22
48
JavaScript
MIT License

View all related MCP servers

Foundry MCP Project