Foundry MCP

🚀 🧠 Foundry MCP プロジェクト

このプロジェクトは、Foundryツールとのインタラクションを目的としたモデルコンテキストプロトコル（MCP）サーバーです。Foundryプロジェクトの管理、テストの実行、コントラクトのビルドなど、一連のツールとユーティリティを提供します。

📂 プロジェクト構造

pyproject.toml       # プロジェクト設定ファイル
README.md            # プロジェクトドキュメント
uv.lock              # 依存関係ロックファイル
LLM/                 # ドキュメントとSDKの使用説明
src/eth_wh_mcp/      # MCPサーバーのソースコード

✨ 主な機能

• Foundryプロジェクトの作成：新しいFoundryプロジェクトを初期化します。
• コントラクトのビルド：複数のオプションを持つSolidityコントラクトをコンパイルします。
• テストの実行：詳細な設定を持つFoundryプロジェクトのテストを実行します。
• コントラクトの検査：ABI、バイトコード、その他のメタデータを取得します。
• スクリプトの実行：Solidityスクリプトを実行します。
• ローカルノードの起動：AnvilまたはChiselを使用してローカルEthereumノードを起動します。
• 高度なCastコマンド：castを使用してEthereum関連のコマンドを実行します。

📦 インストール

1. リポジトリをクローンします：

   git clone <repository-url>
   

2. Foundryツール（forge、cast、anvilなど）がインストールされ、PATHに追加されていることを確認します。

💻 使用例

基本的な使用法

MCPサーバーの実行

MCPサーバーを起動するには、次のコマンドを実行します。

python src/eth_wh_mcp/main.py

利用可能なツール

MCPサーバーは以下のツールを提供します。

• create_project：新しいFoundryプロジェクトを初期化します。
• build_project：現在のFoundryプロジェクトをビルドします。
• test_project：Foundryプロジェクトのテストを実行します。
• clone_contract：Etherscanからコントラクトをクローンします。
• run_script：Solidityスクリプトを実行します。
• run_cast_command：castコマンドを実行します。
• start_anvil_with_options：オプションを指定してAnvilローカルEthereumノードを起動します。
• start_chisel_with_options：オプションを指定してChisel Solidity REPLを起動します。
• inspect_contract：コントラクトのメタデータを検査します。
• snapshot_project：ガス使用量のスナップショットを作成します。
• coverage_project：テストのカバレッジを表示します。

📚 ドキュメント

MCP Python SDK

LLM/python-mcp-sdk.mdファイルを参照して、MCP Python SDKの詳細な使用方法を確認してください。これにはサーバーの構築、ツールの使用、ヒント、コンテキストの処理が含まれます。

開発

ローカルデバッグ

開発モードでMCPサーバーを実行するには、次のコマンドを使用します。

mcp dev src/eth_wh_mcp/main.py --with-editable .

実行時の実行

サーバーを実行するには、次のコマンドを使用します。

python src/eth_wh_mcp/main.py

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。