@sinco Labevm MCP Server

🚀 イーサリアムモデルコンテキストプロトコル（EVMCP）サーバー

本プロジェクトは、イーサリアムネットワークに基づくモデルコンテキストプロトコル（EVMCP）サーバーを提供します。このサーバーは、様々なツールインターフェースを公開することで、外部システムやアプリケーションがイーサリアムブロックチェーンと相互作用できるようにします。

🚀 クイックスタート

機能概要

本プロジェクトは、イーサリアムネットワークに基づくモデルコンテキストプロトコル（EVMCP）サーバーを提供します。このサーバーは、様々なツールインターフェースを公開することで、外部システムやアプリケーションがイーサリアムブロックチェーンと相互作用できるようにします。

プロジェクト目標

• 信頼性が高く使いやすいイーサリアムブロックチェーンの相互作用インターフェースを提供する。
• 複数のイーサリアム関連操作ツールを実装し、アドレス管理やトークン操作などの機能をサポートする。
• 開発者が統合しやすいように、詳細なドキュメントとサンプルコードを提供する。

✨ 主な機能

プロジェクト構造

evm-mcp-server/
├── src/                # コアサービスコード
│   ├── evm.ts          # メインサーバーのエントリーロジック
│   └── evm-tools.ts    # すべての MCP ツールの定義と実装
├── test/               # テストコード
│   └── client.ts       # サンプルテストクライアント
├── build/              # コンパイル生成された JavaScript コード（`pnpm run build` で自動生成）
├── .env.example        # 環境変数のサンプルファイル
├── .env                # 環境変数の設定ファイル（自分で作成する必要があり、バージョン管理されません）
├── .gitignore          # 無視するファイルのリスト
├── package.json        # プロジェクトの依存関係とスクリプト
├── pnpm-lock.yaml      # pnpm ファイル
├── tsconfig.json       # TypeScript コンパイラの設定
└── README.md           # 英語版の説明
└── README.zh.md        # 中国語版の説明

環境要件

• オペレーティングシステム: Linux または macOS（推奨）をサポート
• Node.js バージョン: 16.0.0 以上
• pnpm バージョン: 4.0.0 以上
• イーサリアム RPC ノード: 利用可能なイーサリアム JSON-RPC エンドポイント（Infura、Alchemy など）が必要

📦 インストール

1. リポジトリをクローンする

git clone https://github.com/your-repository/evm-mcp-server.git
cd evm-mcp-server

2. 依存関係をインストールする

pnpm install

3. 環境変数ファイルを作成する

.env.example ファイルをコピーして .env という名前にし、必要に応じて設定を変更します。

cp .env.example .env

.env ファイルを編集し、以下の内容を記入します。

WALLET_PRIVATE_KEY=your-wallet-private-key
RPC_PROVIDER_URL=https://eth-mainnet.alchemyapi.io/v2/your-api-key
DEFAULT_GAS_LIMIT=100000
DEFAULT_GAS_PRICE=200000

4. コードをコンパイルする

pnpm run build

5. サーバーを起動する

pnpm run start

利用可能なツール

🔧 技術詳細

開発ガイド

1. 開発環境を準備する

pnpm run dev

2. コードをテストする

pnpm test

3. デバッグログを表示する

pnpm run debug

ドキュメントの参照先

• イーサリアム黄書: https://ethereum.org/en/whitepaper/
• JSON-RPC 標準: https://www.jsonrpc.org/specification
• Solidity プログラミング言語: https://soliditylang.org/

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

⚠️ 重要な注意事項

• 秘密鍵の管理: .env ファイル内の WALLET_PRIVATE_KEY が漏洩したり、バージョン管理システムにコミットされたりしないようにしてください。
• RPC のセキュリティ: HTTPS を使用して RPC プロバイダーとの通信を安全にし、定期的に API キーを更新してください。
• アクセス権の制御: 実際のニーズに応じて、サーバーエンドポイントへのアクセス権を制限してください。

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

コミュニティからの貢献を歓迎します！本プロジェクトに貢献する方法については、CONTRIBUTING.md を参照してください。

📈 プロジェクトの現状

• バージョン: v1.0.0
• 保守状態: 積極的に保守中
• 更新履歴: CHANGELOG.md を参照してください。

ご支援とご利用いただき、ありがとうございます！フィードバックやヘルプが必要な場合は、サポートチームのメールアドレス support@evm-mcp-server.com までご連絡ください。