Funding Rates MCP

Funding Rates MCP

主要な暗号資産取引所のリアルタイムの資金調達率データを提供し、エージェントがアービトラージの機会を検出できるようにする MCP サーバーです。

特長

• リアルタイムの資金調達率：Binance、OKX、Bybit、Bitget、Gate、CoinEx の現在の資金調達率を取得します。
• ピボットテーブル形式の出力：シンボルを行、取引所を列として表示し、資金調達率の最大差を示す Divergence 列を含みます。
• Claude Desktop との連携：インタラクティブなクエリに対応する MCP サーバーとして動作します。

インストール

前提条件

• Python 3.10+
• 依存関係の管理用の uv
• Claude Desktop（任意。インタラクティブなクエリに使用）
• Git

手順

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

   git clone https://github.com/kukapay/funding-rates-mcp.git
   cd funding-rates-mcp
   

2. uv で依存関係をセットアップします：

   uv sync
   

3. Claude Desktop を設定します：

   Claude Desktop で使用するには：

   1. Claude の設定ファイルを編集します：
      • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
      • Windows：%APPDATA%\Claude\claude_desktop_config.json
   2. MCP サーバーを追加します：

      {
        "mcpServers": {
          "funding-rates-mcp": {
            "command": "uv",
            "args": ["--directory", "/absolute/path/to/funding-rates-mcp", "run", "funding-rates-mcp"]
          }
        }
      }
      

   3. Claude Desktop を再起動します。ハンマーアイコンが表示されていることを確認してください。

使用方法

ツール

このサーバーは、資金調達率を照会するための次の MCP ツールを提供します：

• compare_funding_rates：
  • 説明：指定された取引所における複数のシンボルの現在の資金調達率を比較し、各シンボルの資金調達率の最大差を示す Divergence 列を含む、ピボット形式の Markdown テーブルを返します。
  • パラメーター：
    • symbols (List[str])：取引ペアのリスト（例：["BTC/USDT:USDT", "ETH/USDT:USDT"]）。必須です。
    • exchanges (List[str], optional)：比較する取引所のリスト（例：["binance", "okx"]）。デフォルトでは、サポートされているすべての取引所（binance、okx、bybit、bitget、gate、coinex）が対象になります。
    • params (Dict, optional)：API 呼び出しに使用する追加パラメーターです。デフォルトは {} です。
  • 戻り値：シンボルを行、取引所を列とし、資金調達率をパーセンテージ形式の値で表示する、Divergence 列を含む Markdown テーブルです。
  • 例：以下の「例」セクションを参照してください。

プロンプト

このサーバーには、自然言語のクエリを生成するための次の MCP プロンプトが含まれています：

• compare_funding_rates_prompt：
  • 説明：サポートされているすべての取引所の資金調達率を比較する自然言語のプロンプトを生成します。Claude Desktop への入力に適しています。
  • パラメーター：
    • symbols (List[str])：取引ペアのリスト（例：["BTC/USDT:USDT", "ETH/USDT:USDT"]）。必須です。
  • 戻り値：文字列形式のプロンプト（例：「binance、okx、bybit、bitget、gate、coinex で BTC/USDT:USDT、ETH/USDT:USDT の資金調達率を比較してください。」）。
  • 使用方法：Claude Desktop がユーザーのクエリを解釈するために内部で使用するほか、MCP Inspector でのテストにも使用します。

例

資金調達率の比較

• 入力（Claude Desktop）： 「すべての取引所で BTC/USDT:USDT と ETH/USDT:USDT の資金調達率を比較してください。」
• 出力：

  Current funding rates:
  
  | Symbol\Exchange | binance   | okx       | bybit     | bitget    | gate      | coinex    | Divergence |
  |-----------------|-----------|-----------|-----------|-----------|-----------|-----------|------------|
  | BTC/USDT:USDT   | 0.005161% | 0.007548% | 0.010000% | 0.002900% | -0.019200% | -0.035013% | 0.045013%  |
  | ETH/USDT:USDT   | 0.010000% | 0.005839% | 0.010000% | 0.010000% | -0.008200% | 0.000000%  | 0.018200%  |
  

特定の取引所の比較

• 入力（Claude Desktop）： 「Binance、OKX、Bybit で SOL/USDT:USDT の資金調達率を比較してください。」
• 出力：

  Current funding rates:
  
  | Symbol\Exchange | binance   | okx       | bybit     | Divergence |
  |-----------------|-----------|-----------|-----------|------------|
  | SOL/USDT:USDT   | -0.015312% | -0.003639% | -0.004467% | 0.011673%  |
  

ライセンス

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