Artifact To MCP Generator

🚀 スマートコントラクトMCPサーバージェネレーター

このツールは、デプロイされた任意のスマートコントラクトに対して、型定義付きのMCP（モデルコンテキストプロトコル）サーバーを自動生成します。

🚀 クイックスタート

このプロジェクトは、スマートコントラクトのアーティファクト（ABI、IDLなど）からMCPサーバーを自動生成するチェーン非依存のツールを提供します。生成されたサーバーは、Model Context Protocolを通じて、スマートコントラクトの機能を大型言語モデル (LLMs) が使用できるツールとして公開します。

✨ 主な機能

• スマートコントラクトのABI/IDLから型定義付きのMCPサーバーを自動生成
• 複数のブロックチェーンプラットフォーム（Ethereum、Solanaなど）をサポート
• さまざまなプログラミング言語のカスタマイズ可能なテンプレートを提供
• CLIツールを備え、開発ワークフローへの統合が容易

📦 インストール

go install github.com/openhands/mcp-generator/cmd/generate-mcp@latest

💻 使用例

基本的な使用法

# Ethereum ABIからTypeScriptのMCPサーバーを生成
generate-mcp --artifact path/to/abi.json --lang ts --output ./my-mcp-server

# Solana IDLからPythonのMCPサーバーを生成
generate-mcp --artifact path/to/idl.json --chain solana --lang python --output ./my-mcp-server

高度な使用法

# 現在のテスト用コマンド
go run cmd/generate-mcp/main.go -a examples/erc20.json --name "ERC20 Token" --address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

# テストディレクトリに移動
cd mcp-tests

# 依存関係をインストール
npm install

# テストを実行
./run-tests.sh

📚 ドキュメント

概要

このプロジェクトは、スマートコントラクトのアーティファクト（ABI、IDLなど）からMCPサーバーを自動生成するチェーン非依存のツールを提供します。生成されたサーバーは、Model Context Protocolを通じて、スマートコントラクトの機能を大型言語モデル (LLMs) が使用できるツールとして公開します。

何がMCP？

Model Context Protocol (MCP) は、アプリケーションが大型言語モデルにコンテキストを提供する方法を標準化するためのオープンプロトコルです。これにより、LLMは標準インターフェースを介して安全にツールやデータソースにアクセスできます。

MCPはクライアント-サーバーアーキテクチャを採用しています：

• MCPホスト：Claude Desktop、IDE、またはMCPを介してデータにアクセスしたいAIツールなど
• MCPクライアント：サーバーと1対1の接続を維持するプロトコルクライアント
• MCPサーバー：標準化されたModel Context Protocolを通じて特定の機能を公開する軽量プログラム

テスト

このプロジェクトには、生成されたMCPサーバーとMCP Inspectorとの正しい相互作用を検証するためのエンドツーエンドテストが含まれています。テストではPlaywrightを使用してMCP Inspector UIとの相互作用を自動化し、以下のことを検証します：

1. MCPサーバーが正常に接続される
2. すべてのツールが正しくリストされる
3. 各ツールが有効なパラメータで実行できる
4. エラー処理が予期通りに動作する

詳細については tests/README.md を参照してください。

開発状況

このプロジェクトは現在積極的に開発中です。現在の進捗状況については Phase 1 issue を参照してください。

📄 ライセンス

MIT