Skip to main content
Glama

Foundry MCP Project

by lhemerly

🧠 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

  1. Clone the repository:
    git clone <repository-url>
  2. 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.

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

  1. 📂 Project Structure
    1. 🚀 Features
      1. 🛠️ Installation
        1. Installing via Smithery
        2. Manual Installation
      2. 🏗️ Usage
        1. Running the MCP Server
        2. Available Tools
      3. 📖 Documentation
        1. MCP Python SDK
      4. 🧪 Development
        1. Local Debugging
        2. Runtime Execution
      5. 📜 License

        Related MCP Servers

        • 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
        • 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
        • 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
        • 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

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/lhemerly/foundry-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server