Paradex

🚀 MCP Paradex サーバー

MCP Paradex サーバーは、Paradex 取引プラットフォーム用のモデルコンテキストプロトコル（MCP）サーバーの実装です。Paradex プラットフォームとのインタラクションに必要なインターフェースとツールを提供します。

🚀 クイックスタート

MCP Paradex サーバーを使用する前に、いくつかの前提条件を満たす必要があります。また、サーバーのインストール、設定、起動の手順を以下に説明します。

✨ 主な機能

システムツール

• paradex-system-config：Paradex システムのグローバル設定を取得します。
• paradex-system-time：Paradex サーバーの時間を取得します。
• paradex-system-state：現在のシステム状態を取得します。

市場ツール

• paradex-market-names：利用可能な市場のリストを取得します。
• paradex-market-details：特定の市場の詳細情報を取得します。
• paradex-market-summaries：すべての市場または特定の市場の集計データを取得します。
• paradex-funding-data：市場の資金レートデータを取得します。
• paradex-orderbook：現在の注文簿を取得します。
• paradex-klines：過去の K 線データを取得します。
• paradex-trades：最近の取引記録を取得します。
• paradex-bbo：最良の売買価格を取得します。

アカウントツール

• paradex-account-summary：アカウントの概要情報を取得します。
• paradex-account-positions：現在のポジションを取得します。
• paradex-account-fills：約定記録を取得します。
• paradex-account-funding-payments：資金費用の支払い記録を取得します。
• paradex-account-transactions：取引履歴を取得します。

注文ツール

• paradex-account-open-orders：すべての未決済注文を取得します。
• paradex-create-order：新しい注文を作成します。
• paradex-cancel-order：指定された注文をキャンセルします。
• paradex-cancel-order-by-client-id：クライアント ID を使用して注文をキャンセルします。
• paradex-cancel-all-orders：すべての未決済注文をキャンセルします。
• paradex-get-order-status：注文の状態を取得します。
• paradex-get-order-by-client-id：クライアント ID を使用して注文の状態を取得します。
• paradex-get-orders-history：注文の履歴記録を取得します。

保険庫ツール

• paradex-vault-list：利用可能なすべての保険庫をリストします。
• paradex-vault-details：特定の保険庫の詳細情報を取得します。
• paradex-vaults-config：保険庫の設定オプションを取得します。
• paradex-vault-balance：保険庫の残高を取得します。
• paradex-vault-summary：保険庫の状態の概要を取得します。
• paradex-vault-transfers：保険庫の振込記録を取得します。
• paradex-vault-positions：保険庫の現在のポジションを取得します。
• paradex-vault：保険庫の取引履歴を取得します。

📦 インストール

前提条件

• オペレーティングシステム：Linux、macOS、または Windows をサポートしています。
• Python バージョン：Python 3.6 以上が必要です。

インストール手順

1. リポジトリをクローンする

以下のコマンドを使用してプロジェクトのリポジトリをクローンします。

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

2. 仮想環境を作成する（オプションだが推奨）

プロジェクトディレクトリに移動し、仮想環境を作成します。

cd mcp-paradex-server
python -m venv venv
source venv/bin/activate  # Linux/macOS の場合
venv\Scripts\activate      # Windows の場合

3. 依存関係をインストールする

プロジェクトに必要な依存関係をインストールします。

pip install -r requirements.txt

📚 ドキュメント

設定

環境変数の設定

.env ファイルを編集し、以下の内容を追加します。

API_KEY=your_api_key
API_SECRET=your_api_secret
PARADEX_URL=https://api.paradex.com

設定ファイルの例

.env.example ファイルには設定例が記載されています。

DEBUG=True
PORT=8000
DATABASE_URL=sqlite:///db.sqlite3

サーバーの起動

以下のコマンドを実行して MCP Paradex サーバーを起動します。

python run.py

サーバーの停止

Ctrl+C を使用するか、スクリプトを作成してサービスを正常に終了させます。

開発ガイド

新機能の作成

1. app/ ディレクトリに新しいルートまたはサービスを作成します。
2. config.py を使用してプロジェクトのパラメータを設定します。

テスト

ユニットテストを実行します。

pytest tests/

プロジェクト構造

• app/：アプリケーションの主要なロジックが含まれています。
• config.py：設定ファイルです。
• requirements.txt：依存関係のリストです。
• run.py：起動スクリプトです。

貢献ガイド

1. コードを提出する前に、すべてのテストに合格していることを確認してください。
2. 提出するコードは、プロジェクトのコーディング規約に従ってください。
3. 新機能にはドキュメントとテストを追加してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。