Foundry MCP Server

🚀 Foundry MCP Server

A simple, lightweight, and fast MCP (Model Context Protocol) server that leverages the Foundry toolchain (Forge, Cast, and Anvil) to provide Solidity development capabilities.

🚀 Quick Start

The server connects large language model assistants to the Foundry ecosystem, enabling them to:

• Interact with nodes (local Anvil instances or remote RPC endpoints)
• Analyze smart contracts and transactions
• Query blockchain data
• Perform blockchain operations

✨ Features

Core Functions

1. MCP Protocol Support: Implements the MCP specification, allowing models to interact with external tools and services.
2. Foundry Integration: Seamlessly integrates with tools like Forge and Cast, providing full Foundry functionality.
3. Blockchain Connectivity: Supports multiple blockchain networks, including Ethereum, Polygon, etc.

Key Features

• Supports Solidity smart contract development
• Provides interactive debugging capabilities
• Integrates transaction analysis tools
• Supports block explorer queries
• Provides wallet balance query functionality

📦 Installation

Installation Steps

1. Clone the repository:

git clone https://github.com/your-repo.git

2. Install dependencies:

npm install

3. Start the server:

npm start

💻 Usage Examples

Using in the Claude Desktop Application 🎯

After installation and configuring the Claude desktop application, you must completely close and reopen the Claude application to see the tavily - mcp server. You should see a hammer icon at the bottom - left of the application, indicating that MCP tools are available. Click on the icon to view more tool details.

Now, Claude will have full access to the Foundry - MCP server. If you enter the following examples in the Claude desktop application, you should be able to see the effects of the Foundry - MCP server tools.

Examples

1. Transaction Analysis:

Can you analyze this transaction and explain what it does?
https://etherscan.io/tx/0xcb73ad3116f19358e2e649d4dc801b7ae0590a47b8bb2e57a8e98b6daa5fb14b

2. Balance Query:

Query the balances of ETH and USDT on the mainnet for the wallet address 0x195F46025a6926968a1b3275822096eB12D97E70.

3. Send Transaction:

Forward 0.5 USDC to 0x195F46025a6926968a1b3275822096eB12D97E70 on the mainnet.

4. Deploy Contract/Run Script:

Deploy a mock ERC20 contract on the local Anvil instance and name it "Fire Coin".

🙏 Acknowledgments

• Model Context Protocol for providing the MCP specification
• Anthropic for providing the Claude desktop application

📄 License

The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and non - infringement. The author shall not be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage. Users use the software at their own risk and should exercise caution.