Evm MCP Server

🚀 イーサリアム仮想マシン（EVM） MCP サーバードキュメント

このドキュメントは、イーサリアム仮想マシン（EVM）の MCP サーバーに関する詳細な情報を提供します。このサーバーは、多様なブロックチェーンネットワークをサポートし、リアルタイムのブロックチェーンイベントの監視やスマートコントラクトの読み書き操作など、様々な機能を提供します。

🚀 クイックスタート

インストールと実行

インストール

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

git clone git@github.com:your-repository.git mcp-evm-server
cd mcp-evm-server
npm install

2. サーバーを起動します：

npm run dev

3. コンソールにアクセスします： 起動後、ブラウザまたはターミナルの curl コマンドを使用して http://localhost:5000 にアクセスします。

設定

src/server/http-server.ts ファイルを編集して、以下の設定を調整します：

• PORT: サーバーのポート番号。デフォルトは 5000 です。
• NETWORKS: サポートされるブロックチェーンネットワーク。例えば、Ethereum、Polygon などです。
• RPC_ENDPOINTS: サードパーティの RPC プロバイダーの URL です。
• WALLET_PROVIDERS: ウォレットプロバイダーの設定です。

✨ 主な機能

コアコンポーネント

1. HTTP サーバー
   • Server-Sent Events (SSE) を使用してリアルタイム更新を提供します。
   • RESTful API と長時間ポーリングをサポートします。
2. ブロックチェーンサービス
   • EVM 関連のブロックチェーン操作を処理します。
3. リソースシステム
   • ブロックチェーンデータリソースの URI を公開します。例えば、チェーン情報、ブロック、トランザクションなどです。
4. ツールセット
   • ブロックチェーン分析とインタラクションツールを提供します。

コア機能特性

• 複数のブロックチェーンネットワークをサポートします。
• 組み込みのウォレットとトランザクションサービスを備えています。
• リアルタイムのブロックチェーンイベント監視が可能です。
• スマートコントラクトの読み書き操作をサポートします。
• トークン残高の照会と送金ができます。
• NFT と ERC1155 トークンをサポートします。

🔧 技術詳細

ネットワーク設定

type NetworkConfig = {
  chainId: number;
  name: string;
  rpcUrls: string[];
  blockExplorers?: Record<string, string>;
};

アカウントとトランザクション

• 複数のウォレットプロバイダー（例：MetaMask、WalletConnect）をサポートします。
• トランザクションの署名とブロードキャストを行います。
• トランザクションレシートの解析を行います。

📚 ドキュメント

セキュリティに関する注意事項

• 秘密鍵の安全：秘密鍵はトランザクションの署名にのみ使用され、サーバーには保存されません。
• 認証：本番環境では、追加の認証メカニズムを導入することをおすすめします。
• 通信の暗号化：本番環境では、HTTPS を使用してデプロイしてください。
• レート制限：悪用攻撃を防止するために、レート制限を設定してください。
• 高価値サービス：高価値サービスには、確認手順を追加してください。

プロジェクト構造

mcp-evm-server/
├── src/
│   ├── index.ts                # 標準入出力サーバーのエントリーファイル
│   ├── server/                 # サーバー関連のファイル
│   │   ├── http-server.ts      # SSE をサポートする HTTP サーバーの実装
│   │   └── server.ts           # 汎用サーバーの設定
│   ├── core/
│   │   ├── chains.ts           # ブロックチェーンチェーンの定義とツール
│   │   ├── resources.ts        # MCP リソースの実装
│   │   ├── tools.ts            # MCP ツールの実装
│   │   ├── prompts.ts          # MCP プロンプトの実装
│   │   └── services/           # コアブロックチェーンサービス
│   │       ├── index.ts        # 操作のエクスポート
│   │       ├── network.ts      # ネットワークの設定と管理
│   │       ├── wallet.ts       # ウォレット機能の実装
│   │       ├── transaction.ts  # トランザクション処理のロジック
│   │       └── contract.ts     # スマートコントラクトのインタラクション
├── package.json                # プロジェクトの依存関係とスクリプト
└── README.md                   # プロジェクトのドキュメント

開発ガイド

1. 開発環境

   • Node.js と TypeScript を使用します。
   • 依存関係の管理には pnpm または npm をインストールします。

2. デバッグテクニック

   • 開発サーバーを起動するには、npm run dev を実行します。
   • プログラムの実行時ディレクトリは src/ です。

3. ビルドとデプロイ

   • 本番用のビルドを行うには、npm run build を実行します。
   • クラウドサービス（例：AWS、Azure）にデプロイします。

4. コントリビューションガイド

   • コードを提出する前に、ユニットテストを通過させてください。
   • コードスタイルの規則に従ってください。

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しており、詳細は LICENSE ファイルを参照してください。

付録

よくある質問

1. 新しいブロックチェーンネットワークを追加するにはどうすればいいですか？
   • chains.ts ファイルに対応する設定を追加します。
2. どのウォレットプロバイダーがサポートされていますか？
   • 現在、MetaMask、WalletConnect などの主要なプロバイダーがサポートされています。
3. トランザクションが失敗した場合、どう対処すればいいですか？
   • エラー処理モジュールでエラーをキャッチし、再試行します。

連絡先

• メール：contact@example.com
• GitHub：github.com/your-repository

イーサリアム仮想マシン（EVM） MCP サーバーをご利用いただき、ありがとうございます！ さらなる支援が必要な場合は、ドキュメントを参照するか、サポートチームにお問い合わせください。