Sperax Crypto MCP

🚀 BNB Chain MCP Server

BNB ChainとEVMブロックチェーン向けの最も包括的なモデルコンテキストプロトコルサーバーです。AIエージェントが自然言語でBNB Chain、opBNB、その他のEVMネットワークと対話できるようにします。

🚀 クイックスタート

60秒以内で起動して実行できます！

オプション1: Claude Desktop (推奨)

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "bnb-chain-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnb-chain-mcp@latest"]
    }
  }
}

オプション2: Cursor / VS Code

MCP設定に以下を追加します。

{
  "mcpServers": {
    "bnb-chain-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnb-chain-mcp@latest"]
    }
  }
}

オプション3: ChatGPT Developer Mode

1. ChatGPT設定でDeveloper Modeを有効にします。
2. HTTPサーバーを起動します。

   npx @nirholas/bnb-chain-mcp@latest --http
   

3. ChatGPT Settings → Appsで、Create appをクリックします。
4. サーバーURLを入力します: http://localhost:3001/mcp
5. Developer modeメニューを介して会話でアプリを選択します。

📖 ChatGPTの完全セットアップガイド

オプション4: npxによる即時起動

# stdioモード (Claude, Cursor)
npx @nirholas/bnb-chain-mcp@latest

# HTTPモード (ChatGPT Developer Mode)
npx @nirholas/bnb-chain-mcp@latest --http

# SSEモード (レガシークライアント)
npx @nirholas/bnb-chain-mcp@latest --sse

✨ 主な機能

機能マトリックス

ツールカテゴリ

🌐 サポートされているネットワーク

カスタムネットワークの追加

{
  "mcpServers": {
    "bnb-chain-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnb-chain-mcp@latest"],
      "env": {
        "CUSTOM_RPC_56": "https://your-bnb-rpc.com",
        "CUSTOM_RPC_1": "https://your-eth-rpc.com"
      }
    }
  }
}

📦 インストール

サーバーモード

npmからのインストール (推奨)

# npxで直接実行 (インストール不要)
npx @nirholas/bnb-chain-mcp@latest

# またはグローバルにインストール
npm install -g @nirholas/bnb-chain-mcp

# その後実行
bnb-chain-mcp

ソースからのインストール

# クローン
git clone https://github.com/nirholas/bnb-chain-mcp
cd bnb-chain-mcp

# 依存関係のインストール
bun install

# ビルド
bun run build

# 開発サーバーの実行 (stdio - Claude)
bun dev

# 開発サーバーの実行 (HTTP - ChatGPT)
bun dev:http

# 開発サーバーの実行 (SSE - レガシー)
bun dev:sse

Dockerを使用したインストール

# ビルド
docker build -t bnb-chain-mcp .

# stdioモードで実行
docker run -it bnb-chain-mcp

# HTTPモードで実行
docker run -p 3001:3001 bnb-chain-mcp --http

⚙️ 設定

環境変数

完全な設定例

{
  "mcpServers": {
    "bnb-chain-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnb-chain-mcp@latest"],
      "env": {
        "PRIVATE_KEY": "0x...",
        "COINGECKO_API_KEY": "CG-xxx",
        "LUNARCRUSH_API_KEY": "xxx",
        "CUSTOM_RPC_56": "https://bsc-rpc.publicnode.com",
        "CUSTOM_RPC_1": "https://eth-rpc.publicnode.com",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

Claude Desktopの設定

# 設定ファイルを開く
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

# 設定ファイルを開く
notepad %APPDATA%\Claude\claude_desktop_config.json

# 設定ファイルを開く
nano ~/.config/claude/claude_desktop_config.json

📊 データソース

このMCPサーバーは以下のAPIと統合されています。

💬 使用例

価格クエリ

ユーザー: "BNBの現在の価格はいくらですか？"

AI: get_priceツールを使用 → "BNBは現在$XXX.XXで取引されており、過去24時間で2.5%上昇しています。"

セキュリティチェック

ユーザー: "このトークンは安全ですか？ 0x..."

AI: check_token_securityとdetect_honeypotを使用 → "⚠️ 警告: このトークンにはいくつかの危険信号があります..."

DEX分析

ユーザー: "BNBの最良の流動性プールを見せてください"

AI: get_dex_poolsを使用 → "これがBNBチェーンでTVLが高いトッププールです..."

マルチチェーンポートフォリオ

ユーザー: "すべてのチェーンで私のウォレットを確認してください: 0x..."

AI: get_portfolioを使用 → "あなたの総ポートフォリオ価値は5つのチェーンで合計$Xです..."

DeFi調査

ユーザー: "BNBチェーンで最良の収益農業の機会は何ですか？"

AI: get_yield_farmsとget_tvlを使用 → "これがトップの収益機会です..."

🏗️ アーキテクチャ

┌──────────────────────────────────────────────────────────────────────────────┐
│                          BNB Chain MCP Server                                │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐                        │
│  │    stdio     │  │     HTTP     │  │      SSE     │   Transport Layer      │
│  │   (Claude)   │  │   (ChatGPT)  │  │   (Legacy)   │                        │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘                        │
│         │                 │                 │                                │
│         └─────────────────┼─────────────────┘                                │
│                           │                                                  │
│                           ▼                                                  │
│  ┌───────────────────────────────────────────────────────────────────────┐   │
│  │                        MCP Protocol Handler                           │   │
│  │     Tools Registration  |  Resource Management  |  Prompt Templates   │   │
│  └───────────────────────────────────────────────────────────────────────┘   │
│                           │                                                  │
│         ┌─────────────────┼─────────────────┐                                │
│         ▼                 ▼                 ▼                                │
│  ┌────────────┐    ┌────────────┐    ┌────────────┐                          │
│  │ Blockchain │    │   Market   │    │  Security  │    Tool Categories       │
│  │   Tools    │    │    Data    │    │   Tools    │                          │
│  └─────┬──────┘    └─────┬──────┘    └─────┬──────┘                          │
│        │                 │                 │                                 │
│        ▼                 ▼                 ▼                                 │
│  ┌───────────────────────────────────────────────────────────────────────┐   │
│  │                         Provider Integrations                         │   │
│  │   viem | CoinGecko | DefiLlama | GoPlus | LunarCrush | GeckoTerminal  │   │
│  └───────────────────────────────────────────────────────────────────────┘   │
│                           │                                                  │
│                           ▼                                                  │
│  ┌───────────────────────────────────────────────────────────────────────┐   │
│  │                           EVM Networks                                │   │
│  │   BNB Chain | Ethereum | Arbitrum | Polygon | Base | Optimism | ...   │   │
│  └───────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

モジュール構成

src/
├── index.ts              # エントリーポイント
├── server/
│   ├── stdio.ts          # stdioトランスポート
│   ├── http.ts           # HTTPトランスポート
│   └── sse.ts            # SSEトランスポート
├── tools/
│   ├── blockchain/       # コアチェーン操作
│   ├── tokens/           # トークン操作
│   ├── defi/             # DeFiプロトコル
│   ├── security/         # セキュリティチェック
│   ├── market/           # 市場データ
│   └── social/           # ソーシャルセンチメント
├── providers/
│   ├── coingecko.ts      # CoinGecko API
│   ├── defillama.ts      # DefiLlama API
│   ├── goplus.ts         # GoPlus Security
│   └── ...
└── utils/
    ├── chains.ts         # チェーン設定
    ├── abi.ts            # 共通ABI
    └── format.ts         # フォーマッター

🔐 セキュリティ

セキュリティモデル

ベストプラクティス

• ⚠️ 公開設定でPRIVATE_KEYを共有しないでください
• ✅ 環境変数またはシークレット管理を使用してください
• ✅ 可能な場合は読み取り専用モードを使用してください
• ✅ トークンの安全性を常に確認してから操作してください
• ✅ トランザクションのシミュレーションを実行してから実行してください

❓ トラブルシューティング

🗺️ ロードマップ

実装予定のすべての暗号通貨/ブロックチェーン/DeFi/Web3機能の包括的なロードマップです。

凡例

• ✅ 実装済み
• 🚧 開発中
• 📋 計画中

🔗 コアブロックチェーン操作

ネットワークとチェーン

ブロック

トランザクション

アカウント/ウォレット

💰 トークン操作

ネイティブトークン

ERC - 20 (ファンジブルトークン)

ERC - 721 (NFT)

ERC - 1155 (マルチトークン)

その他のトークン標準

🏦 DeFi - 分散型取引所 (DEX)

交換

DEX分析

流動性提供

AMMタイプのサポート

🏦 DeFi - 貸付と借入

貸付

借入

清算

孤立市場

🥩 DeFi - ステーキング

ネイティブステーキング

流動性ステーキング

LPステーキング/ファーミング

再ステーキング

📊 DeFi - デリバティブ

永久先物

オプション

合成資産

🌉 クロスチェーンとブリッジ

ブリッジ

クロスチェーンメッセージング

アトミックスワップ

🗳️ ガバナンス

投票

トークンロック

Snapshot (オフチェーン)

🔐 セキュリティと分析

コントラクト分析

トークンセキュリティ

ウォレットセキュリティ

📈 価格と市場データ

価格フィード

分析

🆔 アイデンティティとドメイン

ENS (Ethereum Name Service)

その他の名前サービス

DIDsと検証可能な資格情報

🖼️ NFTとメタバース

NFTマーケットプレイス

NFT作成

NFTファイナンス

メタバース

🔔 イベントとサブスクリプション

イベントリスニング

Webhookと通知

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

読み取り操作

書き込み操作

コントラクトのデプロイ