MCP Ethers Server

🚀 MCP プロトコル実装

MCP プロトコル実装は、ERC20、ERC721、ERC1155 トークン標準をサポートする強力なツールです。このプロトコルはウォレット機能、トークン操作、スマートコントラクトとの相互作用を統合し、ブロックチェーン開発を大きく便利にします。

🚀 クイックスタート

インストールと使用

環境変数の設定

以下の内容をプロジェクトのルートディレクトリにある .env ファイルに追加してください。

ALCHEMY_API_KEY=your_alchemy_api_key
INFURA_PROJECT_ID=your_infura_project_id

サービスの起動

ターミナルで以下のコマンドを実行して、MCP サーバーを起動します。

npm run start

ネットワーク設定

ネットワーク設定を config/networks.json ファイルに追加してください。例えば：

{
  "mainnet": {
    "name": "Ethereum Main Network",
    "chainId": 1,
    "providerType": "ALCHEMY"
  },
  "ropsten": {
    "name": "Ethereum Test Network - Ropsten",
    "chainId": 3,
    "providerType": "INFURA"
  }
}

✨ 主な機能

ウォレット機能

• ウォレット作成：新しい Ethereum ウォレットアドレスを生成します。
• 秘密鍵管理：秘密鍵を環境変数またはメモリに保存することをサポートします。
• 残高照会：指定されたアドレスの ETH とトークンの残高を取得します。

トークン操作

• ERC20：トークンの基本機能（送金、承認など）を実装します。
• ERC721：NFT の铸造、転送、所有権照会をサポートします。
• ERC1155：単一および複数のトークンの転送を含む、バッチトークン操作を実装します。

スマートコントラクトとの相互作用

• メソッド呼び出し：ABI インターフェースを通じてスマートコントラクトのメソッドを呼び出します。
• イベント監視：ブロックチェーン上のイベントをリアルタイムで監視します。
• トランザクション処理：トランザクション要求を送信して確認します。

🔧 技術詳細

キャッシュメカニズム

システムは以下の操作に対してキャッシュ機能を有効にしています。

• トークン情報（名前、シンボル、小数点以下の桁数）
• トークン残高
• コントラクトメソッド呼び出し

デフォルトでは、キャッシュの有効期限は 1 時間です。config/cache.json でキャッシュポリシーをカスタマイズできます。

レート制限

システムの安定性を確保し、乱用を防止するために、サーバーは以下の操作に対してレート制限を実施しています。

• 書き込み操作（送金、承認）
• ウォレット生成
• コントラクトとの相互作用

エラー処理

システムは詳細なエラー情報とステータスコードを提供し、デバッグと問題解決を容易にします。すべてのエラーは安全に処理され、機密データの漏洩を防ぎます。

📚 ドキュメント

開発ガイド

プロジェクトのビルド

以下のコマンドを実行してビルドします。

npm run build

テストスイート

Bun を使用してすべてのテストを実行する（推奨）

# ターミナルで Hardhat ノードを起動する
npx hardhat node

# すべてのテストケースを実行する
bun test

MCP クライアントのテストのみを実行する

bun run test:client:mcp

📄 ライセンス

MCP プロトコル実装は MIT ライセンスに基づいており、自由な使用、変更、配布が許可されています。

⚠️ 重要提示

ウォレット機能はデフォルトで秘密鍵をファイルシステムに保存しません。機密操作を行う際は、saveToEnv オプションを慎重に使用してください。

⚠️ 重要提示

.env ファイルの安全性を確保し、API キーの漏洩を避けてください。