MCP Server Ccxt

🚀 暗号通貨市場データ MCP サーバー

主要な取引所のデータを統合し、リアルタイムおよび過去の暗号通貨市場データを提供する Model Context Protocol (MCP) サーバーです。このサーバーにより、Claude などの LLM が現在の価格を取得し、市場トレンドを分析し、詳細な取引情報にアクセスできるようになります。

🚀 クイックスタート

この暗号通貨市場データ MCP サーバーは、主要な取引所のデータを統合し、LLMにリアルタイムと過去の市場データを提供します。以下では、その機能、インストール方法、使用方法などを説明します。

✨ 主な機能

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

  • 現在の暗号通貨価格
  • 売買スプレッドを含む市場概要
  • 取引量上位の取引ペア
  • 複数の取引所をサポート

• 過去データ分析

  • OHLCV（ローソク足）データ
  • 価格変動分析
  • 取引量と時間の関係
  • データ可視化ツール

• 取引所サポート

  • 複数の主流暗号通貨取引所をサポート
  • ビンサン、Coinbase、火幣などを含む
  • 統一された API インターフェースを提供

📦 インストール

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

# 実装待ち
pytest tests/

手動インストール

1. リポジトリをクローンします：

   git clone [リポジトリのURL]
   cd 暗号通貨-mcp-サーバー
   

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

   uv pip install -e .
   

💻 使用例

サーバーの起動

# 実装待ち
pytest tests/

Claude Desktop への接続

1. 以下のコードをターミナルにコピーします：

   uv pip install crypto-mcp-server
   

2. サーバーを起動します：

   python3 src/server.py
   

利用可能なツール

インタラクティブな方法

• get-price
  • 機能：指定された暗号通貨の価格情報を取得します。
  • 例：

    curl --location 'http://localhost:8080 getPrice' \
         --header 'Content-Type: application/json' \
         --data-raw '{
             "symbol": "BTC/USDT"
         }'
    

🔧 技術詳細

依存関係管理

• Python の依存関係は pipenv で管理されます。
• プロジェクトのルートディレクトリには Pipfile が含まれています。
• インストールが必要なパッケージには、以下が含まれます：
  • ccxt
  • flask
  • requests

アーキテクチャ設計

1. サーバー側

   • RESTful API インターフェースを実装しています。
   • Flask フレームワークを使用しています。
   • CCXT ライブラリを統合してデータを取得します。

2. クライアント側

   • コマンドラインツールを提供します。
   • グラフィカルユーザーインターフェースのサポートは開発中です。
   • 拡張可能なプラグインシステムがあります。

エラー処理

一般的なエラーと解決策

1. 取引所への接続問題

   • ネットワーク状態を確認します。
   • 取引所がオンラインであることを確認します。
   • 取引ペアの存在を検証します。

2. レート制限

   • リクエスト間に遅延を追加します。
   • 高頻度のクエリには異なる取引所を使用します。
   • 個々の取引所の制限ポリシーを確認します。

トラブルシューティング

一般的な問題

1. データ形式エラー

   • 取引ペアの形式が正しいことを確認します（例：BTC/USDT、BTCUSDT ではない）。
   • 時間範囲の指定を確認します。
   • 数値パラメータが有効な範囲内であることを検証します。

2. 接続タイムアウト

   • ネットワーク遅延を確認します。
   • API アドレスを切り替えます。
   • タイムアウト設定を増やします。

開発ガイド

コードの提出

1. リポジトリをフォークします：

   git clone [リポジトリのURL]
   cd 暗号通貨-mcp-サーバー
   

2. 機能ブランチを作成します：

   git checkout -b feature/新機能名
   

3. 変更を加えてコミットします：

   git add .
   git commit -m "新機能の追加"
   

4. プルリクエストを提出します。

📄 ライセンス

MIT ライセンス - 詳細は LICENSE ファイルを参照してください。

謝辞

• CCXT チームには、取引所インターフェースを提供してくれたことに感謝します。
• Model Context Protocol には、MCP 規格を定義してくれたことに感謝します。
• 主要な暗号通貨取引所には、市場データ API を提供してくれたことに感謝します。