Foundry MCP Server

ファウンドリー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）

手動設定

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

[!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 サーバーツールが実際に動作するのを確認できます。

例

1. トランザクション分析：

2. 残高の照会:

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

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

謝辞✨

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

免責事項

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