MCP Paradex Py

🚀 MCP Paradex Server

このプロジェクトは、AIアシスタント（Claudeなど）とParadexの先物取引プラットフォームをつなぐブリッジとして機能します。MCP標準を使用することで、AIアシスタントは以下のことができます。

• Paradexから市場データを取得する
• 取引口座とボートを管理する
• 注文を発行および管理する
• ポジションと残高を監視する

🚀 クイックスタート

このセクションでは、MCP Paradex Serverの概要、前提条件、インストール方法、サーバーの実行方法、Smithery.aiとの統合方法などを説明します。

概要

このプロジェクトは、AIアシスタント（Claudeなど）とParadexの先物取引プラットフォームをつなぐブリッジとして機能します。MCP標準を使用することで、AIアシスタントは以下のことができます。

• Paradexから市場データを取得する
• 取引口座とボートを管理する
• 注文を発行および管理する
• ポジションと残高を監視する

前提条件

• Python 3.10+

インストール

Smitheryを介したインストール

Smitheryを介してClaude Desktop用のmcp-paradex-pyを自動的にインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @sv/mcp-paradex-py --client claude

uvを使用したインストール（高速な代替手段）

1. このリポジトリをクローンします。

   git clone https://github.com/sv/mcp-paradex-py.git
   cd mcp-paradex-py
   

2. 仮想環境を作成します。

   uv venv
   source .venv/bin/activate  # Windowsの場合: .venv\Scripts\activate
   

3. 依存関係をインストールします。

   uv pip install -e .

設定

設定を行います。

cp .env.template .env

その後、.envファイルを編集して、Paradexの認証情報を設定します。

サーバーの実行

Docker（推奨）

docker build . -t sv/mcp-paradex-py

CursorでMCPをコマンドとして追加

公開のみ

docker run --rm -i sv/mcp-paradex-py

取引を許可する

docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=0xprivatekey -i sv/mcp-paradex-py

Smithery.aiとの統合

このMCPサーバーは、MCPサーバーを発見してデプロイするためのプラットフォームであるSmithery.aiと互換性があります。

Claude Desktopの設定

Smithery.aiを介してClaude Desktopでこのサーバーを使用するには、以下の手順を実行します。

1. Claude Desktopを開き、メニューから開発者モードを有効にします。
2. 設定 > 開発者に移動し、「設定を編集」をクリックします。
3. claude_desktop_config.jsonに以下の設定を追加します。

{
  "mcpServers": {
    "paradex": {
      "command": "uvx",
      "args": ["--with-editable", ".", "mcp-paradex"],
      "env": {
        "PARADEX_ENVIRONMENT": "testnet",
        "PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}

4. your_ethereum_private_keyを実際のParadexの秘密鍵に置き換えます。
5. ファイルを保存し、Claude Desktopを再起動します。

Smithery.aiレジストリ

サーバーには、Smithery.aiレジストリ用のメタデータが含まれたsmithery.yamlファイルがあります。このサーバーをSmithery.aiに公開する場合は、Smithery CLIを使用できます。

# Smithery CLIをインストールする
npm install -g @smithery/cli

# Smitheryにログインする
smithery login

# サーバーを公開する
smithery publish

Smithery.aiへの公開に関する詳細情報は、Smitheryドキュメントを参照してください。

✨ 主な機能

利用可能なリソースとツール

リソース

システムリソース

• paradex://system/config - Paradexのシステム設定と取引所の基本情報を取得する
• paradex://system/time - エポックからのミリ秒単位での現在のシステム時刻を取得する
• paradex://system/state - 現在のParadexシステムの運用状態を取得する

市場リソース

• paradex://markets - Paradexから利用可能な市場のリストを取得する
• paradex://market/summary/{market_id} - 特定の取引ペアの詳細な市場情報を取得する

ボートリソース

• paradex://vaults - Paradexで利用可能なすべてのボートをリストする
• paradex://vaults/config - ボートのグローバル設定を取得する
• paradex://vaults/balance/{vault_id} - 特定のボートの残高を取得する
• paradex://vaults/summary/{vault_id} - ボートの包括的な概要を取得する
• paradex://vaults/transfers/{vault_id} - ボートの入出金履歴を取得する
• paradex://vaults/positions/{vault_id} - ボートの現在の取引ポジションを取得する
• paradex://vaults/account-summary/{vault_id} - ボートの取引口座情報を取得する

ツール

システムツール

• paradex_system_config - グローバルなParadexシステム設定を取得する
• paradex_system_state - 現在のシステム状態を取得する

市場ツール

• paradex_markets - 市場に関する詳細情報を取得する。ベース/クォート資産、ティックサイズ、その他の取引パラメータが含まれる。
• paradex_market_summaries - 価格、出来高、24時間の変化、その他の主要な市場指標を含む要約を取得する。
• paradex_funding_data - 先物市場の過去の資金レートデータを取得する。
• paradex_orderbook - カスタマイズ可能な深度で市場の現在のオーダーブックを取得する。
• paradex_klines - 市場の過去のローソク足（OHLCV）データを取得する。
• paradex_trades - 価格、サイズ、タイムスタンプ情報を含む市場の最近の取引を取得する。
• paradex_bbo - 市場の最良買い注文と最良売り注文（最も狭いスプレッド）を取得する。

口座ツール

• paradex_account_summary - 口座の概要情報を取得する
• paradex_account_positions - 現在の口座ポジションを取得する
• paradex_account_fills - 口座の取引約定を取得する
• paradex_account_funding_payments - 口座の資金支払いを取得する
• paradex_account_transactions - 口座の取引履歴を取得する

注文ツール

• paradex_open_orders - 口座のすべての未決済注文を取得する
• paradex_create_order - Paradexで新しい注文を作成する
• paradex_cancel_orders - 既存の注文をキャンセルする
• paradex_order_status - 注文のステータスを取得する
• paradex_orders_history - 口座の過去の注文を取得する

ボートツール

• paradex_vaults - 特定のボートまたはすべてのボートに関する詳細情報を取得する。フィルタリングオプション付き。
• paradex_vaults_config - ボートのグローバル設定を取得する。手数料、制限、その他の設定が含まれる。
• paradex_vault_balance - ボートの現在の残高を取得する。利用可能/ロックされた資金情報が含まれる。
• paradex_vault_summary - ボートのパフォーマンス、残高、および活動の包括的な概要を取得する。
• paradex_vault_transfers - ボートの入出金履歴を取得する。
• paradex_vault_positions - ボートの現在の取引ポジションを取得する。市場、サイズ、エントリー価格の詳細が含まれる。
• paradex_vault_account_summary - ボートの取引口座情報を取得する。証拠金とリスク指標が含まれる。

取引分析プロンプト

このMCPサーバーは、AIアシスタントが複雑な取引分析を行い、取引戦略を生成するために使用できる構造化されたプロンプトを提供します。

市場分析

• market_overview - 暗号通貨市場の包括的な概要を取得する。トップの上昇株/下落株、高出来高市場、資金レートの異常、および市場マイクロ構造分析が含まれる。
• market_analysis - 特定の市場の詳細な技術分析とマイクロ構造分析を行う。サポート/レジスタンスレベル、チャートパターン、オーダーブック分析、およびポジション推奨が含まれる。

ポジションとポートフォリオ管理

• position_management - 既存のポジションの包括的な分析を行う。ポートフォリオのヒート、相関関係、リスク指標、および利益確定と損失管理の具体的な推奨が含まれる。
• create_optimal_order - ボラティリティ、流動性、リスク許容度、および理想的なエントリー戦略に基づいて、市場の最適な注文パラメータを設計する。
• hedging_strategy - 相関分析、ヘッジ比率の計算、および実装計画を使用して、特定のポジションの効果的なヘッジ戦略を開発する。
• portfolio_risk_assessment - 取引ポートフォリオの徹底的なリスク分析を行う。エクスポージャー分析、相関評価、VaR計算、およびリスク軽減の推奨が含まれる。
• liquidation_protection - 未決済ポジションの清算リスクを特定し、軽減する。重症度分類と保護戦略が含まれる。

投資戦略

• vault_analysis - 投資意思決定のためのボートの包括的な分析を行う。パフォーマンス指標、リスクプロファイル、および適合性評価が含まれる。
• funding_rate_opportunity - 市場全体の資金レートの裁定取引の機会を特定し、評価する。収益計算と実装戦略が含まれる。
• trading_consultation - 個人化された取引アドバイスと相談のための対話型プロンプトシーケンス。

📚 ドキュメント

MCPドキュメント

クライアントにParadexのドキュメントへのアクセスを提供することで、大幅に良い結果が得られます。

"paradex-docs-mcp": {
   "command": "uvx",
   "args": [
      "--from",
      "mcpdoc",
      "mcpdoc",
      "--urls",
      "Paradex:https://docs.paradex.trade/llms.txt",
      "--transport",
      "stdio"
   ]
}

🤝 コントリビューション

このプロジェクトへのコントリビューション方法、開発環境のセットアップ、およびコーディング標準については、CONTRIBUTING.mdを参照してください。

📄 ライセンス

MITライセンス