ファウンドリーMCPサーバー

Foundry ツールチェーン (Forge、Cast、Anvil) を使用して Solidity 開発機能を提供する、シンプルで軽量かつ高速な MCP (Model Context Protocol) サーバーです。

概要

このサーバーは、LLM アシスタントを Foundry エコシステムに接続し、次のことを可能にします。

ノード（ローカル Anvil インスタンスまたはリモート RPC エンドポイント）と対話する
スマートコントラクトとブロックチェーンデータを分析する
キャストを使用して一般的なEVM操作を実行する
Solidity コードとスクリプトを管理、デプロイ、実行する
永続的な Forge ワークスペースで作業する

特徴

ネットワークインタラクション

ローカルの Anvil インスタンスを起動および管理する
任意のリモートネットワークに接続します (RPC を指定するだけ)
ネットワーク/チェーン情報を取得する

契約のやり取り

契約関数を呼び出す（読み取り専用）
トランザクションをコントラクトに送信する（ PRIVATE_KEYが設定されている場合）
取引の領収書を取得する
契約ストレージの読み取り
トランザクショントレースを分析する
ブロックエクスプローラからコントラクトABIとソースを取得する

Solidity開発

専用のForgeワークスペースを維持する
Solidityファイルの作成と編集
依存関係をインストールする
Forgeスクリプトを実行する
契約を展開する

ユーティリティ関数

契約アドレスを計算する
契約バイトコードのサイズを確認する
ガス料金の見積もり
単位間の変換（16進数から10進数など）
ウォレットを生成する
イベントログを取得する
ルックアップ関数とイベントシグネチャ

使用法

このサーバーは、MCPクライアント向けのMCPツールプロバイダーとして設計されています。クライアントに接続すると、クライアント（claudeデスクトップ、カーソル、クライアントなど）がSolidityおよびオンチェーン操作を直接実行できるようになります。

要件

Node.js v18+
ファウンドリツールチェーン（Forge、Cast、Anvil）

手動設定

システムに Foundry ツール (Forge、Cast、Anvil) がインストールされていることを確認します。
curl -L https://foundry.paradigm.xyz | bash foundryup
サーバーのクローンを作成して構築します。
bun i && bun build
クライアント設定を更新します (例: Claude デスクトップ):

 "mcpServers": {
    "foundry": {
      "command": "node",
      "args": [
        "path/to/foundry-mcp-server/dist/index.js"
      ],
      "env" :{
        "PRIVATE_KEY": "0x1234",
      }
    }
 }

[!NOTE] PRIVATE_KEYはオプションです

NPM パッケージを使用したセットアップ

近日公開

構成

サーバーは次の環境変数をサポートしています。

RPC_URL : 何も指定されていない場合に使用するデフォルトのRPC URL（オプション）
PRIVATE_KEY : トランザクションに使用する秘密鍵（オプション）

[!注意] メインネットの資金で鍵を追加しないでください。コードでは安全に使用されていますが、LLMは悪意のあるトランザクションを送信して悪意のあるトランザクションを生成してしまう可能性があります。テスト/開発目的でのみ使用してください。LLMを信頼しないでください。

ワークスペース

サーバーは、すべての Solidity ファイル、スクリプト、依存関係に対して~/.mcp-foundry-workspaceに永続的な Forge ワークスペースを維持します。

ツール

アンビル

anvil_start : 新しいAnvilインスタンスを開始する
anvil_stop : 実行中の Anvil インスタンスを停止する
anvil_status : Anvilが実行中かどうかを確認し、そのステータスを取得します。

キャスト

cast_call : コントラクト関数を呼び出す（読み取り専用）
cast_send : トランザクションをコントラクト関数に送信する
cast_balance : アドレスのETH残高を確認する
cast_receipt : トランザクションのレシートを取得する
cast_storage : 特定のスロットの契約ストレージを読み取る
cast_run : ローカル環境で公開されたトランザクションを実行する
cast_logs : 署名またはトピックでログを取得する
cast_sig : 関数またはイベントシグネチャのセレクタを取得する
cast_4byte : 4バイトディレクトリから関数またはイベントシグネチャを検索します
cast_chain : 現在のチェーンに関する情報を取得する

フォージ

forge_script : ワークスペースからForgeスクリプトを実行する
install_dependency : Forgeワークスペースの依存関係をインストールする

ファイル管理

create_solidity_file : ワークスペースに Solidity ファイルを作成または更新します
read_file : ワークスペースからファイルの内容を読み取ります
list_files : ワークスペース内のファイルを一覧表示する

ユーティリティ

convert_eth_units : EVM 単位 (wei、gwei、hex) を変換します。
compute_address : デプロイされるコントラクトのアドレスを計算する
contract_size : デプロイされたコントラクトのバイトコードサイズを取得する
estimate_gas : トランザクションのガスコストを見積もる

Claude デスクトップアプリでの使用 🎯

インストールが完了し、Claude デスクトップアプリの設定が完了したら、Claude デスクトップアプリを完全に閉じてから再度開いて、tavily-mcp サーバーを確認してください。アプリの左下にハンマーアイコンが表示され、利用可能な MCP ツールが表示されます。ハンマーアイコンをクリックすると、利用可能なツールの詳細が表示されます。

これで、claude は foundry-mcp サーバーに完全にアクセスできるようになります。以下の例を Claude デスクトップアプリに挿入すると、foundry-mcp サーバーツールが実際に動作するのを確認できます。

例

トランザクション分析：

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

残高の照会:

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

トランザクションの送信:

Transfer 0.5 USDC to 0x195F46025a6926968a1b3275822096eB12D97E70 on Mainnet. 

契約のデプロイ/スクリプトの実行:

Deploy a mock ERC20 contract to a local anvil instance and name it "Fire Coin".

謝辞✨

MCP仕様のモデルコンテキストプロトコル
クロード・デスクトップのAnthropic

免責事項

本ソフトウェアは現状のまま提供されます。明示的または黙示的を問わず、本ソフトウェアの安全性または正確性について、いかなる保証、表明、または保証も行いません。本ソフトウェアは監査を受けていないため、意図したとおりに動作することを保証するものではなく、ユーザーは遅延、障害、エラー、脱落、送信情報の損失、または資金の損失を経験する可能性があります。作成者は上記のいずれについても責任を負いません。ユーザーは慎重に使用し、自己責任で使用してください。

Foundry MCP Server

Integrations