MCP パラデックス サーバー

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

概要

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

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

前提条件

• Python 3.10以上

インストール

Smithery経由でインストール

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

pipの使用

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

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. 依存関係をインストールします:
   uv pip install -e .

構成

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

次に、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 のドキュメントを参照してください。

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

リソース

システムリソース

• system://status - システムとParadex接続の現在のステータスを取得します
• system://version - サーバーと依存関係の詳細なバージョン情報を取得します
• system://health - サーバーの基本的なヘルスチェックを実行します

市場リソース

• market://public/markets - Paradexから利用可能なマーケットのリストを取得します
• market://public/info - 一般的な市場情報とステータスを取得します

Vaultリソース

• vaults://list - アカウントに関連付けられているすべてのボールトを一覧表示します
• vaults://balance - 特定の金庫の残高を取得する
• vaults://details - ボールトに関する詳細情報を取得します

ツール

システムツール

• 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 - マージンとリスクの指標を含む金庫の取引口座情報を取得します

貢献

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

ライセンス

MITライセンス