Provides tools for Ethereum blockchain development through Foundry, including creating projects, compiling contracts, running tests, launching local nodes, and executing blockchain commands
Offers comprehensive Solidity development support including contract compilation, inspection, testing, and running a Solidity REPL (Chisel) for interactive development
🧠 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
🚀 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:
Manual Installation
- Clone the repository:
- Ensure Foundry tools (
forge
,cast
,anvil
, etc.) are installed and available in your PATH.
🏗️ Usage
Running the MCP Server
To start the MCP server:
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:
Runtime Execution
To execute the server:
📜 License
This project is licensed under the MIT License. See the LICENSE file for details.
This server cannot be installed
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
- AsecurityAlicenseAqualityA 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 -74JavaScriptMIT License
- AsecurityAlicenseAqualityA 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 -31118TypeScriptMIT License
- AsecurityAlicenseAqualityA 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 -28376299TypeScriptMIT License
- AsecurityAlicenseAqualityA 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 -12248JavaScriptMIT License
Appeared in Searches
- Executing Operations and Maintenance Tasks, Such as Deployment and Upgrades
- A server for EVM (Extended Virtual Machine) MCP
- MCP to Control CAD Tools for Building Models and Automating Manufacturing
- Guidance on Writing Git Commit Messages for Pushing to GitHub
- Automating web browser searches using Chrome