Paradex

🚀 MCP Paradex 服務器

MCP Paradex 服務器是專為 Paradex 交易平臺打造的模型上下文協議（MCP）服務器實現。它為用戶與 Paradex 平臺的交互提供了豐富的接口和實用工具，極大地便利了相關操作。

🚀 快速開始

MCP Paradex 服務器為與 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：獲取保險庫交易歷史。

📦 安裝指南

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 許可證。