Bsc MCP

🚀 BNBChain MCP

Binance Smart Chain (BSC) とやり取りするための包括的なモデルコンテキストプロトコル (MCP) サーバーです。トークン転送、DEX 操作、スマートコントラクトの相互作用など、安全で効率的なツールを提供します。

🚀 クイックスタート

BNBChain MCPは、AIエージェントやアプリケーションがBinance Smart Chainエコシステムとやり取りできる本番環境で使用可能なMCPサーバーです。トークン転送、PancakeSwap統合、ミームトークン取引、包括的なウォレット管理などのブロックチェーン操作に対して、安全で型安全なインターフェースを提供します。

1. 初期設定

対話型のセットアップウィザードを実行します。

bnbchain-mcp --init

ウィザードでは、以下の情報を求められます。

• BSCウォレットの秘密鍵 (必須) - ウォレットの秘密鍵
• ウォレットのパスワード (必須) - 暗号化のために最低6文字
• カスタムRPC URL (オプション) - デフォルトはBinanceの公開RPC

2. インストールの確認

bnbchain-mcp --version

3. MCPサーバーの起動

npm start
# または
node build/index.js

✨ 主な機能

🔐 セキュリティ

• 秘密鍵の保存に AES-256暗号化 を使用
• ウォレットの資格情報に bcryptパスワード保護 を使用
• トークン検証に GoPlusセキュリティ統合 を使用
• 安全な設定管理

💱 DeFi操作

• PancakeSwap V2/V3統合 によるトークン交換
• 流動性管理 (ポジションの追加/削除)
• ポジション追跡 とポートフォリオ管理
• ガスを最適化したトランザクションルーティング

🪙 トークン管理

• ネイティブBNBの転送
• シンボルまたはアドレスによるBEP-20トークンの転送
• ミームトークンの作成と取引 (Four.Memeプラットフォーム)
• トークンのセキュリティ分析と検証

🤖 AI対応

• モデルコンテキストプロトコル (MCP) 準拠
• Claude Desktopとのシームレスな統合
• AIエージェント用の構造化されたツールAPI
• 型安全なTypeScript実装

📦 インストール

前提条件

• Node.js 18以上 (ESMサポートが必要)
• npmまたはyarnパッケージマネージャー

グローバルインストール

npm install -g bnbchain-mcp

ローカル開発

git clone <repository-url>
cd bsc-mcp
npm install
npm run build

💻 使用例

基本的な使用法

# 初期設定
bnbchain-mcp --init

# インストールの確認
bnbchain-mcp --version

# MCPサーバーの起動
npm start

高度な使用法

# ネイティブトークンの転送
transferNativeToken to=0x1234567890123456789012345678901234567890 amount=1.0

# BEP-20トークンの転送
transferBEP20Token token=BNB to=0x1234567890123456789012345678901234567890 amount=1.0

📚 ドキュメント

利用可能なツール

ウォレット操作

PancakeSwap操作

ミームトークン操作

セキュリティと分析

コントラクトアドレス

開発

プロジェクトのビルド

npm run build

テストの実行

# すべてのテストを実行
npm test

# 特定のテストスイートを実行
npm run test:privateAES

再設定

設定を更新するには、次のコマンドを実行します。

bnbchain-mcp --init

開発スクリプト

# ビルドと初期化
npm run init:build

# 自動公開 (メンテナー用)
npm run publish:auto

アーキテクチャ

プロジェクト構造

bsc-mcp/
├── src/
│   ├── cli/              # CLIコマンドハンドラー
│   ├── functions/        # コアビジネスロジック
│   ├── tools/            # MCPツールの実装
│   ├── lib/              # 共有ライブラリとABI
│   ├── types/            # TypeScriptの型定義
│   ├── config.ts         # 設定管理
│   ├── main.ts           # MCPサーバーのエントリーポイント
│   └── index.ts          # CLIのエントリーポイント
├── build/                # コンパイルされたJavaScriptの出力
└── scripts/              # ビルドとデプロイメントスクリプト

セキュリティアーキテクチャ

• 秘密鍵の暗号化：ユーザーが提供したパスワードでAES-256暗号化
• パスワードのハッシュ化：安全なパスワード保存にbcryptを使用
• 設定の保存：暗号化されたローカル設定ファイル
• トークンの検証：セキュリティチェックにGoPlus SDKを統合

モデルコンテキストプロトコル (MCP)

このプロジェクトは、モデルコンテキストプロトコル を実装しています。これは、AIエージェントが外部ツールやデータソースとやり取りするための標準化されたプロトコルです。

MCPの利点

• ✅ 構造化された通信：型安全なリクエスト/レスポンスパターン
• ✅ AIエージェントとの互換性：Claude、OpenAI、および他のMCP互換エージェントと動作
• ✅ 安全なアーキテクチャ：暗号化された資格情報を持つサーバーベースの実行
• ✅ 拡張可能な設計：新しいツールや機能を簡単に追加できる

設定

設定は暗号化された形式で以下の場所に保存されます。

• macOS/Linux：~/.bnbchain-mcp/config.json
• Windows：%USERPROFILE%\.bnbchain-mcp\config.json

環境変数

オプションの環境変数を設定できます。

• BSC_RPC_URL：カスタムRPCエンドポイント
• MORALIS_API_KEY：拡張データアクセスのためのMoralis APIキー

ロードマップ

完了済み ✅

• [x] CLI設定ウィザード
• [x] Claude Desktopの統合
• [x] トークンのデプロイと転送
• [x] PancakeSwap V2/V3の統合
• [x] ミームトークン取引のサポート
• [x] セキュリティ分析ツール

進行中 🚧

• [ ] エラーハンドリングとリトライロジックの強化
• [ ] マルチウォレットサポート
• [ ] トランザクション履歴の追跡

計画中 📋

• [ ] トークンチャートの統合 (DEXTools、CoinGecko)
• [ ] Telegramボットの統合
• [ ] 高度なAIトレーディング戦略
• [ ] クロスチェーンブリッジのサポート

🔧 技術詳細

技術スタック

サポートされるネットワーク

BNB Smart Chainメインネット

• チェーンID：56
• デフォルトRPC：https://bsc-dataseed.binance.org
• カスタムRPC：環境設定を介して構成可能

📄 ライセンス

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

サポート

問題、質問、または貢献については、以下の方法で対応します。

• GitHubで問題を報告する
• 既存のドキュメントを確認する
• トラブルシューティングセクションを確認する

謝辞

• モデルコンテキストプロトコルSDK で構築
• Viem と PancakeSwap SDK で動作
• GoPlus によるセキュリティ分析

次世代のWeb3 AIエージェント向けに構築 🤖⚡

⚠️ 重要提示

• 秘密鍵やウォレットのパスワードを決して共有しないでください。
• 強力なパスワード (最低6文字、できれば長いパスワード) を使用してください。
• 設定ファイルを安全に保管し、バージョン管理システムにコミットしないでください。
• トランザクションを実行する前に、トークンのアドレスを確認してください。
• 大きな取引を行う前に、少量でテストしてください。
• 未知のトークンを取引する前に、セキュリティチェックの結果を確認してください。

💡 使用建议

• 初期設定時には、ウォレットの秘密鍵やパスワードを安全に保管することをおすすめします。
• トランザクションを実行する前に、必ずトークンのアドレスや残高を確認してください。
• セキュリティ分析ツールを定期的に使用して、トークンの安全性を確認してください。