Cryptocurrency Market Data MCP Server

Cryptocurrency Market Data MCP サーバー

大手取引所との連携を通じて、リアルタイムおよび過去の暗号資産市場データを提供する Model Context Protocol（MCP）サーバーです。このサーバーを使うと、Claude などの LLM が現在の価格を取得し、市場動向を分析して、詳細な取引情報にアクセスできます。

機能

• リアルタイム市場データ

  • 暗号資産の現在価格
  • ビッド／アスクスプレッドを含む市場概要
  • 出来高上位の取引ペア
  • 複数の取引所に対応

• 過去データの分析

  • OHLCV（ローソク足）データ
  • 価格変動統計
  • 出来高の履歴追跡
  • カスタマイズ可能な時間枠

• 取引所への対応

  • Binance
  • Coinbase
  • Kraken
  • KuCoin
  • HyperLiquid
  • Huobi
  • Bitfinex
  • Bybit
  • OKX
  • MEXC

インストール

Smithery 経由でのインストール

Smithery を使って、Claude Desktop 用の Cryptocurrency Market Data Server を自動的にインストールするには：

npx -y @smithery/cli install mcp-server-ccxt --client claude

手動インストール

# Using uv (recommended)
uv pip install mcp ccxt

# Using pip
pip install mcp ccxt

使い方

サーバーの起動

python crypto_server.py

Claude Desktop への接続

1. Claude Desktop の設定ファイルを開きます：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. サーバー設定を追加します：

{
    "mcpServers": {
        "crypto": {
            "command": "python",
            "args": ["/path/to/crypto_server.py"]
        }
    }
}

3. Claude Desktop を再起動します

利用可能なツール

1. get-price

   • 任意の取引ペアの現在価格を取得します
   • 例：「Binance での BTC/USDT の現在価格はいくらですか？」

2. get-market-summary

   • 詳細な市場情報を取得します
   • 例：「ETH/USDT の市場概要を表示してください」

3. get-top-volumes

   • 出来高上位の取引ペアを一覧表示します
   • 例：「Kraken の取引ペア上位 5 件は何ですか？」

4. list-exchanges

   • 対応している取引所をすべて表示します
   • 例：「どの取引所に対応していますか？」

5. get-historical-ohlcv

   • 過去のローソク足データを取得します
   • 例：「BTC/USDT の過去 7 日間の価格データを 1 時間間隔で表示してください」

6. get-price-change

   • さまざまな時間枠での価格変動を計算します
   • 例：「SOL/USDT の 24 時間の価格変動はいくらですか？」

7. get-volume-history

   • 時間の経過に伴う取引出来高を追跡します
   • 例：「ETH/USDT の過去 1 週間の取引出来高の履歴を表示してください」

クエリの例

サーバーに接続すると、Claude に次のような質問をすることができます：

- What's the current Bitcoin price on Binance?
- Show me the top 5 trading pairs by volume on Coinbase
- How has ETH/USDT performed over the last 24 hours?
- Give me a detailed market summary for SOL/USDT on Kraken
- What's the trading volume history for BNB/USDT over the last week?

技術詳細

依存関係

• mcp：Model Context Protocol SDK
• ccxt：暗号資産取引所取引ライブラリ
• Python 3.9 以降

アーキテクチャ

このサーバーでは次の機能を使用しています：

• 効率的な取引所通信を実現する CCXT の非同期サポート
• LLM 統合のための MCP のツールシステム
• 一貫した出力を実現する標準化されたデータ形式
• 最適なパフォーマンスを実現するコネクションプーリング

エラー処理

このサーバーでは、次のようなケースに対して堅牢なエラー処理を実装しています：

• 無効な取引ペア
• 取引所への接続問題
• レート制限
• 不正な形式のリクエスト
• ネットワークタイムアウト

開発

テストの実行

# To be implemented
pytest tests/

コントリビュート

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. プルリクエストを送信します

ローカル開発

# Clone the repository
git clone [repository-url]
cd crypto-mcp-server

# Install dependencies
uv pip install -e .

トラブルシューティング

よくある問題

1. 取引所への接続エラー

   • インターネット接続を確認してください
   • 取引所が稼働中であることを確認してください
   • 選択した取引所に取引ペアが存在することを確認してください

2. レート制限

   • リクエストの間に遅延を設けてください
   • 高頻度のクエリには別の取引所を使用してください
   • 取引所固有のレート制限を確認してください

3. データ形式の問題

   • 取引ペアの形式を確認してください（例：BTCUSDT ではなく BTC/USDT）
   • 時間枠の指定を確認してください
   • 数値パラメーターが有効な範囲内であることを確認してください

ライセンス

MIT License - 詳細は LICENSE ファイルを参照してください

謝辞

• 取引所との連携には CCXT を使用しています
• MCP 仕様については Model Context Protocol に感謝します
• 市場データ API を提供している暗号資産取引所に感謝します