Paradex Trading

MCP Paradex Server

Paradex 取引プラットフォーム向けの Model Context Protocol（MCP）サーバー実装です。

クイックスタート

初めての方は、Claude Desktop、Claude Code、Cursor、Windsurf、VS Code、Claude.ai web、ChatGPT のセットアップ手順を順を追って説明した**クイックスタートガイド**をご覧ください。

ChatGPT や Claude.ai web 用のリモート HTTP エンドポイントが必要ですか？Railway、Render、Fly.io、AWS Lambda、Docker/VPS のオプションについては、**HTTP デプロイガイド**をご覧ください。

概要

このプロジェクトは、AI アシスタント（Claude など）と、Starknet 上のプライバシー保護型マルチアセット取引所である Paradex（現物、無期限先物、オプション、コモディティ先物に対応）をつなぐブリッジを提供します。MCP 標準を使用することで、AI アシスタントは次の操作を行えます。

• Paradex の市場データを取得する
• 取引アカウントとボールトを管理する
• 注文を発注、管理する
• ポジションと残高を監視する

前提条件

• Python 3.10+

• uv — uvx 実行方法に必要です

  macOS： brew install uv でインストールすると、バイナリが /usr/local/bin に配置され、Claude Desktop などの GUI アプリから参照できます。curl パイプを使ったインストールでは uv が ~/.local/bin に配置されるため、GUI アプリから参照できません。

インストール

クイックスタート

Cursor IDE

クリックすると、この MCP サーバーが Cursor に自動設定されます。

Claude Code CLI

claude mcp add paradex uvx mcp-paradex

Smithery（Claude Desktop）

npx -y @smithery/cli@latest mcp add @tradeparadex/mcp-paradex-py --client claude

標準インストール

PyPI

pip install mcp-paradex

uvx（推奨）

uvx mcp-paradex

開発環境のセットアップ

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

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

2. 開発用依存関係をインストールします。

   uv sync --dev --all-extras
   

3. ローカルで実行します。

   uv run mcp-paradex
   

設定

環境変数

認証のため、次の環境変数を設定します。

• PARADEX_ENVIRONMENT：prod、testnet、nightly のいずれかを設定します（デフォルト：prod）
• PARADEX_ACCOUNT_PRIVATE_KEY：Paradex アカウントの秘密鍵

署名者モード（秘密鍵なし）

鍵を保持する署名プロキシ経由で取引するには、次の 4 つを設定し、 PARADEX_ACCOUNT_PRIVATE_KEY は未設定のままにします。

• PARADEX_SIGNER_HEADER：サーバーが各メッセージハッシュを格納するヘッダー（Base64）
• PARADEX_SIGNER_SIGNATURE：プロキシが置き換える、サーバーが署名として送信するプレースホルダー
• PARADEX_ACCOUNT_ADDRESS：Paradex アカウントのアドレス
• PARADEX_ACCOUNT_PUBLIC_KEY：プロキシが署名に使用する鍵の公開鍵

4 つのうち 1 つでも未設定の場合、すべてのツール呼び出しで設定エラーが返されます。秘密鍵も設定されている場合、サーバーは署名者を使用し、警告をログに記録します。署名者モードではブロック取引ツールを使用できません。

アウトバウンドプロキシ

サーバーは、HTTPS_PROXY、HTTP_PROXY、ALL_PROXY が設定されている場合、これらを介して Paradex API リクエストを送信します。NO_PROXY に記載されたホストはスキップし、SSL_CERT_FILE の CA バンドルを信頼します。

.env ファイルの使用

cp .env.template .env
# Edit .env with your credentials

クライアント設定

Claude Desktop

claude_desktop_config.json に追加します。

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

Docker（ローカル / stdio）

# Build image
docker build . -t tradeparadex/mcp-paradex-py

# Run (public only)
docker run --rm -i tradeparadex/mcp-paradex-py

# Run with trading capabilities
docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=your_key -i tradeparadex/mcp-paradex-py

Docker（AWS Lambda／HTTP）

AWS Lambda によるリモートデプロイには、Lambda Web Adapterを使用する Dockerfile.aws を使います。 このアダプターは Lambda の呼び出しをサーバーの HTTP エンドポイントに橋渡しするため、Lambda 固有のコードは不要です。

# Build
docker build -f Dockerfile.aws -t tradeparadex/mcp-paradex-py-aws .

# Test locally (mirrors Lambda config)
docker run --rm -p 8080:8080 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_STATELESS=true \
  -e MCP_PORT=8080 \
  -e PARADEX_ENVIRONMENT=prod \
  tradeparadex/mcp-paradex-py-aws

サーバーは http://localhost:8080/mcp で利用できます。

Lambda へのデプロイ：

1. イメージを ECR にプッシュします
2. コンテナーイメージから Lambda 関数を作成します
3. Lambda Function URL の呼び出しモードを RESPONSE_STREAM に設定します
4. Lambda 関数に環境変数を設定します：
   • MCP_TRANSPORT=streamable-http
   • MCP_STATELESS=true
   • PARADEX_ENVIRONMENT=prod（または testnet）
   • PARADEX_ACCOUNT_PRIVATE_KEY=your_key（任意、取引を行う場合）

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

リソース

システムリソース

• paradex://system/config - Paradex システム構成を取得
• paradex://system/time - 現在のシステム時刻を取得
• paradex://system/state - システムの稼働状態を取得

マーケットリソース

• paradex://markets - 利用可能なマーケットの一覧
• paradex://market/summary/{market_id} - マーケットの詳細情報

Vault リソース

• paradex://vaults - すべての Vault の一覧
• paradex://vaults/config - グローバル Vault 構成
• paradex://vaults/balance/{vault_id} - Vault の残高
• paradex://vaults/summary/{vault_id} - Vault の包括的な概要
• paradex://vaults/transfers/{vault_id} - 入出金履歴
• paradex://vaults/positions/{vault_id} - 現在の取引ポジション
• paradex://vaults/account-summary/{vault_id} - 取引口座情報

ツール

システムツール

• paradex_system_config - グローバルシステム構成を取得
• paradex_system_state - 現在のシステム状態を取得

マーケットツール

• paradex_markets - マーケットの詳細情報を取得
• paradex_market_summaries - 指標付きのマーケット概要を取得
• paradex_funding_data - 過去の資金調達率データを取得
• paradex_orderbook - 深さをカスタマイズして現在の注文板を取得
• paradex_klines - 過去のローソク足データを取得
• 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_cancel_orders - 既存の注文をキャンセル
• paradex_order_status - 注文のステータスを取得
• paradex_orders_history - 過去の注文を取得

Vault ツール

• paradex_vaults - Vault の詳細情報を取得
• paradex_vaults_config - グローバル Vault 構成を取得
• paradex_vault_balance - Vault の残高を取得
• paradex_vault_summary - Vault の包括的な概要を取得
• paradex_vault_transfers - 入出金履歴を取得
• paradex_vault_positions - 現在の Vault ポジションを取得
• paradex_vault_account_summary - Vault の取引口座情報を取得

取引分析プロンプト

マーケット分析

• market_overview - 暗号資産市場の包括的な概要
• market_analysis - 詳細なテクニカル分析と市場マイクロストラクチャー分析

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

• position_management - 包括的なポジション分析
• create_optimal_order - 最適な注文パラメーターを設計
• hedging_strategy - 効果的なヘッジ戦略を立案
• portfolio_risk_assessment - ポートフォリオのリスクを徹底的に分析
• liquidation_protection - 清算リスクを特定し、軽減

投資戦略

• vault_analysis - 投資判断に役立つ包括的な Vault 分析
• 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 License