MCP Server: Modern SDK Collection & Integration Platform

OLAXBT MCP Server

DeFi、ゲーム、検索ツールなど、複数の MCP サービスをサポートする、スケーラブルなサービスアーキテクチャを備えた、モダンでモジュール型の MCP（Model Context Protocol）サーバーです。

機能

• モジュール型サービスアーキテクチャ：プラグインベースのサービスの読み込みと管理
• サービスレジストリ：サービスの動的な検出、登録、ヘルスモニタリング
• 複数の接続タイプ：HTTP、SSE、WebSocket、標準 MCP プロトコル
• サービス管理：サービスの動的な追加、削除、有効化／無効化、再読み込み
• 組み込みツール：DuckDuckGo 検索と強化されたウェブ検索
• FastAPI バックエンド：高性能な非同期ウェブフレームワーク

クイックスタート

# Install dependencies
pip install -r requirements.txt

# Run server
python run.py

API エンドポイント

コアエンドポイント

• GET / - サーバー情報とステータス
• GET /health - サービスのステータスを含むヘルスチェック
• GET /services - 登録されているすべてのサービスを一覧表示
• GET /tools - 利用可能なすべてのツールを一覧表示
• GET /statistics - サービスとツールの詳細な統計情報

サービス管理

• POST /services/reload/{service_id} - 特定のサービスを再読み込み
• POST /services/load - 設定からサービスを読み込み
• POST /services/add - 新しいサービスを動的に追加
• DELETE /services/{service_id} - サービスを削除
• POST /services/{service_id}/enable - 無効になっているサービスを有効化
• POST /services/{service_id}/disable - サービスを無効化
• GET /services/{service_id}/status - サービスの詳細なステータスを取得

MCP プロトコルエンドポイント

• POST /mcp - 標準 MCP エンドポイント（POST）
• GET /mcp - 標準 MCP エンドポイント（SSE）
• GET /sse - Server-Sent Events エンドポイント
• POST /api/mcp/olaxbt-gateway - カスタム MCP エンドポイント

レガシー MCP エンドポイント

• POST /mcp/tools/list - 利用可能なすべてのツールを一覧表示
• POST /mcp/tools/call - 特定のツールを呼び出す
• POST /mcp/services/list - 利用可能なすべてのサービスを一覧表示

使用例

サービス一覧の取得

curl http://localhost:3000/services

ツール一覧の取得

curl http://localhost:3000/tools

サービスステータスの取得

curl http://localhost:3000/services/meteora/status

MCP プロトコルのリクエスト

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

ツールの使用例

暗号資産価格ツール

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "crypto_price",
    "arguments": {
      "coin_id": "bitcoin",
      "vs_currency": "usd",
      "include_market_data": true,
      "include_24hr_change": true
    }
  }
}

ポートフォリオ追跡ツール

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "portfolio_tracker",
    "arguments": {
      "action": "create",
      "portfolio_id": "my_portfolio",
      "name": "My Crypto Portfolio"
    }
  }
}

DeFi プロトコルツール

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "defi_protocol",
    "arguments": {
      "protocol": "meteora",
      "action": "pools"
    }
  }
}

市場分析ツール

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "market_analysis",
    "arguments": {
      "coin_id": "bitcoin",
      "analysis_type": "technical_indicators",
      "timeframe": "7d"
    }
  }
}

APY 計算ツール

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "apy_calculator",
    "arguments": {
      "calculation_type": "liquidity_pool",
      "protocol": "meteora",
      "principal": 10000,
      "time_period": 365
    }
  }
}

NFT マーケットプレイスツール

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "nft_marketplace",
    "arguments": {
      "action": "collection_stats",
      "collection_slug": "bored-ape-yacht-club",
      "chain": "ethereum"
    }
  }
}

NFT 最低価格

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "nft_marketplace",
    "arguments": {
      "action": "floor_price",
      "collection_slug": "degen-ape-academy",
      "chain": "solana"
    }
  }
}

新しいサービスの追加

curl -X POST http://localhost:3000/services/add \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Service",
    "description": "Custom service description",
    "url": "http://localhost:3003",
    "tools": ["my_tool"],
    "metadata": {"category": "custom"}
  }'

サービス設定

サービスは以下の方法で設定できます：

• 設定ファイル
• 動的な API 呼び出し
• 環境変数

アーキテクチャ

Client → MCP Gateway → Service Manager → Service Registry
                    ↓
                Router → Local Tools

サーバーは以下を提供します：

• サービスマネージャー：サービスのライフサイクルと設定を管理します
• サービスレジストリ：サービスの登録とヘルスモニタリングを管理します
• ルーター：リクエストを適切なサービスまたはローカルツールに振り分けます
• ローカルツール：組み込みの検索ツールとユーティリティツール

ローカル開発

1. 依存関係をインストールします：

pip install -r requirements.txt

2. ローカルで実行します：

python run.py

3. 新しいサービスを追加します：

python scripts/add_service.py

利用可能なツール

MCP サーバーには、以下の包括的なツールが含まれています：

• 暗号資産の価格データ
• DeFi プロトコルとの連携
• ポートフォリオの追跡と分析
• 暗号資産ニュースの集約
• NFT マーケットプレイスのデータ
• 市場分析とテクニカル指標
• APY の計算
• ソーシャルメディア連携
• コミュニケーションツール
• ユーティリティ関数

すべてのツールには包括的なエラー処理が備わっており、API が利用できない場合は、妥当なデフォルト値にフォールバックします。

デプロイ

Python アプリケーションに対応する任意のサーバーにデプロイできます：

1. コードをサーバーにアップロードします
2. 依存関係をインストールします： pip install -r requirements.txt
3. サーバーを起動します： uvicorn app.mcp.server:app --host 0.0.0.0 --port 3000
4. 環境変数を設定します：

   MCP_HOST=0.0.0.0
   MCP_PORT=3000
   MCP_DEBUG=false
   

VSCode 連携

HTTP または SSE 接続の場合は、.vscode/mcp.json を追加します：

{
  "servers": {
    "olaxbt-mcp": {
      "url": "http://localhost:3000/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

利用可能なツール

ローカルツール

検索・情報ツール

• duckduckgo_search - DuckDuckGo を使用したウェブ検索
• web_search - 強化された検索（テキスト、ニュース、画像、動画）
• crypto_news - センチメント分析を含む、暗号資産に特化したニュースの集約

暗号資産・DeFi ツール

• crypto_price - CoinGecko のリアルタイム暗号資産価格と市場データ
• defi_protocol - DeFi プロトコルとの連携（Meteora の流動性プール、Jupiter のスワップアグリゲーター）
• portfolio_tracker - リアルタイム価格を使った暗号資産ポートフォリオの追跡と分析
• apy_calculator - 実際の DeFi プロトコルデータを使った APY の計算：
  • 流動性プールの APY とインパーマネントロスの推定
  • 複利計算を含むイールドファーミングの APY
  • 実際のプロトコルデータを使ったステーキングの APY
  • 月ごとの内訳を含む複利計算
  • CoinGecko から取得する DeFi プロトコルのリアルタイムデータ

NFT・ゲームツール

• nft_marketplace - OpenSea、Magic Eden など主要マーケットプレイスのリアルタイム NFT マーケットプレイスデータ
  • コレクション情報と統計
  • 24 時間・7 日間の変動を含むフロア価格
  • 取引量と販売データ
  • 取引の詳細を含む直近の販売情報
  • Ethereum、Solana、Polygon チェーンに対応

市場分析ツール

• market_analysis - リアルタイムデータを使った高度な市場分析：
  • テクニカル指標（RSI、MACD、ボリンジャーバンド、移動平均）
  • モメンタムと重要な水準を含むトレンド分析
  • 恐怖・強欲指数とソーシャル指標を使った市場センチメント
  • リスク指標（VaR、シャープレシオ、ソルティノレシオ）を使ったボラティリティ分析
  • CoinGecko API から取得するリアルタイムデータ

ユーティリティツール

• notification - 実際の市場データと連携したアラートの設定と管理：
  • CoinGecko の価格をリアルタイムで確認する価格アラート
  • 暗号資産と DeFi に関するニュースアラート
  • 市場概要データを使ったポートフォリオアラート
  • アラートのテストに利用できるリアルタイム市場データ連携

サービスツール

登録済みサービスからツールが動的に読み込まれ、次のものが含まれる場合があります：

• DeFi プロトコル（Meteora など）
• ゲームプラットフォーム（GMGN など）
• 分析サービス
• カスタム連携

プロジェクト構成

app/mcp/
├── server.py           # Main server with FastAPI
├── service_manager.py  # Service lifecycle management
├── router.py           # Request routing and MCP handling
├── config.py           # Configuration management
├── tools.py            # Local tool implementations
└── services/           # Service implementations
    ├── base_service.py # Base service class
    ├── meteora.py      # Meteora DeFi service
    └── gmgn.py         # GMGN Gaming service

要件

• Python 3.8+
• FastAPI
• uvicorn
• duckduckgo-search
• aiohttp
• websockets
• pydantic

環境変数

すべての機能を利用するには、次の環境変数を設定してください：

# NFT Marketplace APIs (optional but recommended)
OPENSEA_API_KEY=your_opensea_api_key_here
RESERVOIR_API_KEY=your_reservoir_api_key_here

# Server Configuration
MCP_HOST=0.0.0.0
MCP_PORT=3000
MCP_DEBUG=false

API キーの取得

1. OpenSea API キー：

   • OpenSea API ドキュメントにアクセスします
   • OpenSea Developer Portalで API キーを登録します

2. Reservoir API キー（任意）：

   • Reservoir API ドキュメントにアクセスします
   • Ethereum／Polygon のデータを拡充する API キーを取得します

注：NFT マーケットプレイスツールは API キーなしでも動作しますが、レート制限があります。API キーを使用すると、レート制限が緩和され、信頼性が向上します。

BNB Chain 上の Nexus での使用

このサービスを OlaXBT Nexus スタックの一部として実行し、利用料金を BNB Chain（BSC／BNB Smart Chain） 上で直接決済できます。

Nexus に接続したウォレットに、BNB Chain 上の BNB または対応するステーブルコインを入金し、Nexus インターフェースからクレジットを購入してください。従量制の利用料金はすべて BNB Chain 上で低手数料にて決済され、後から opBNB または Greenfield に対応したワークフローへ拡張できます。

これにより、エージェントや取引ツールは Nexus を通じてデータやアクションを利用しながら、BNB Chain エコシステム内でネイティブに支払いと会計を処理できます。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。