MCP Paradex Server

MCP パラデックス サーバー

Paradex 取引プラットフォーム用のモデル コンテキスト プロトコル (MCP) サーバー実装。

概要

このプロジェクトは、AIアシスタント（Claudeなど）とParadexの無期限先物取引プラットフォームとの橋渡しを行います。MCP標準を使用することで、AIアシスタントは以下のことが可能になります。

• Paradexから市場データを取得する
• 取引口座と金庫の管理
• 注文の発注と管理
• 位置とバランスを監視する

前提条件

• Python 3.10以上

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の mcp-paradex-py を自動的にインストールするには:

uv を使用する（より高速な代替手段）

1. このリポジトリをクローンします:
   git clone https://github.com/sv/mcp-paradex-py.git cd mcp-paradex-py
2. 仮想環境を作成します。
   uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. 依存関係をインストールします:

構成

設定をセットアップします。

次に、Paradex の資格情報を使用して.envファイルを編集します。

サーバーの実行

Docker（推奨）

カーソルにコマンドとしてMCPを追加します

一般公開のみ

取引を許可する

Smithery.ai 統合

この MCP サーバーは、MCP サーバーを検出および展開するためのプラットフォームであるSmithery.aiと互換性があります。

クロードデスクトップ構成

Smithery.ai 経由で Claude Desktop でこのサーバーを使用するには:

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

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

Smithery.ai レジストリ

サーバーには、Smithery.ai レジストリのメタデータを含むsmithery.yamlファイルが含まれています。このサーバーを Smithery.ai に公開するには、Smithery CLI を使用します。

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

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

リソース

システムリソース

• paradex://system/config - Paradexシステムの構成と取引所の基本情報を取得します
• paradex://system/time - エポックからの現在のシステム時間をミリ秒単位で取得します
• paradex://system/state - 現在の Paradex システムの動作状態を取得します

市場リソース

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

Vaultリソース

• 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 - アカウントの過去の注文を取得する

Vaultツール

• 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ドキュメントへのクライアントアクセスを提供することで、大幅に改善された結果が得られました。

貢献

このプロジェクトへの貢献方法、開発のセットアップ、コーディング標準については、 CONTRIBUTING.md をご覧ください。

ライセンス

MITライセンス