Foundry MCP Server

🚀 Foundry MCP Server

このサーバーは、軽量かつ高速なMCP（Model Context Protocol）サーバーで、Foundryツールチェイン（Forge、Cast、Anvil）を使用してSolidity開発機能を提供します。

🚀 クイックスタート

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

• ノード（ローカルのAnvilインスタンスまたはリモートのRPCエンドポイント）とのやり取り
• スマートコントラクトとブロックチェーンデータの分析
• Castを使用した一般的なEVM操作の実行
• Solidityコードとスクリプトの管理、デプロイ、および実行
• 永続的なForgeワークスペースの使用

✨ 主な機能

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

• ローカルのAnvilインスタンスの起動と管理
• 任意のリモートネットワークへの接続（RPCを指定するだけ）
• ネットワーク/チェーン情報の取得

コントラクトインタラクション

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

Solidity開発

• 専用のForgeワークスペースの維持
• Solidityファイルの作成と編集
• 依存関係のインストール
• Forgeスクリプトの実行
• コントラクトのデプロイ

ユーティリティ関数

• コントラクトアドレスの計算
• コントラクトバイトコードサイズのチェック
• ガスコストの推定
• 単位の変換（16進数から10進数など）
• ウォレットの生成
• イベントログの取得
• 関数とイベントシグネチャの検索

💻 使用例

基本的な使用法

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

必要条件

• Node.js v18+
• Foundryツールチェーン (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デスクトップ）。

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

⚠️ 重要提示

PRIVATE_KEY はオプションです。

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

• 近日公開予定

設定

このサーバーは、以下の環境変数をサポートしています。

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

⚠️ 重要提示

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

ワークスペース

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

📚 ドキュメント

Anvil

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

Cast

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

Forge

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

ファイル管理

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

ユーティリティ

• convert_eth_units: EVM単位（wei、gwei、16進数）間の変換を行います。
• compute_address: デプロイされるコントラクトのアドレスを計算します。
• contract_size: デプロイされたコントラクトのバイトコードサイズを取得します。
• estimate_gas: トランザクションのガスコストを推定します。

💻 使用例

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

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

高度な使用法

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

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

2. 残高の照会

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

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

Transfer 0.5 USDC to 0x195F46025a6926968a1b3275822096eB12D97E70 on Mainnet. 

4. コントラクトのデプロイ/スクリプトの実行

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

📄 ライセンス

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

謝辞 ✨

• Model Context Protocol のMCP仕様
• Anthropic のClaudeデスクトップ