MCP Paradex Py

🚀 MCP Paradex Server

本項目是一個用於Paradex交易平臺的Model Context Protocol (MCP)服務器實現，它搭建起了AI助手（如Claude）與Paradex永續期貨交易平臺之間的橋樑。藉助MCP標準，AI助手能夠執行多種操作，包括從Paradex獲取市場數據、管理交易賬戶和金庫、下單和管理訂單，以及監控頭寸和餘額等。

🚀 快速開始

此項目為AI助手（如Claude）和Paradex永續期貨交易平臺搭建了橋樑。藉助MCP標準，AI助手可實現以下功能：

• 從Paradex獲取市場數據
• 管理交易賬戶和金庫
• 下單和管理訂單
• 監控頭寸和餘額

✨ 主要特性

• 數據交互：AI助手可通過MCP標準從Paradex獲取市場數據，包括系統配置、時間、市場列表、詳細市場信息等。
• 賬戶管理：支持管理交易賬戶和金庫，可查詢金庫餘額、交易頭寸、賬戶信息等。
• 訂單操作：能夠下單、管理訂單，查詢訂單狀態和歷史訂單。
• 交易分析：提供結構化提示，便於AI助手進行復雜的交易分析和生成交易策略。

📦 安裝指南

安裝前提

• Python 3.10+

通過Smithery安裝

若要通過Smithery為Claude Desktop自動安裝mcp - paradex - py，可使用以下命令：

npx -y @smithery/cli install @sv/mcp-paradex-py --client claude

使用uv（更快的替代方法）

1. 克隆此倉庫：

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

2. 創建虛擬環境：

uv venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate

3. 安裝依賴：

uv pip install -e .

配置

設置配置文件：

cp .env.template .env

然後使用你的Paradex憑證編輯.env文件。

💻 使用示例

基礎用法

啟動服務器（以Docker為例，推薦方式）：

docker build . -t sv/mcp-paradex-py

高級用法

僅公開訪問

docker run --rm -i sv/mcp-paradex-py

允許交易

docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=0xprivatekey -i sv/mcp-paradex-py

📚 詳細文檔

Smithery.ai集成

此MCP服務器與Smithery.ai兼容，這是一個用於發現和部署MCP服務器的平臺。

Claude Desktop配置

若要通過Smithery.ai在Claude Desktop中使用此服務器，可按以下步驟操作：

1. 打開Claude Desktop，從菜單中啟用開發者模式。
2. 轉到“設置”>“開發者”，點擊“編輯配置”。
3. 在claude_desktop_config.json中添加以下配置：

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

4. 將your_ethereum_private_key替換為你實際的Paradex私鑰。
5. 保存文件並重啟Claude Desktop。

Smithery.ai註冊

服務器包含一個smithery.yaml文件，其中包含用於Smithery.ai註冊表的元數據。若要將此服務器發佈到Smithery.ai，可使用Smithery CLI：

# 安裝Smithery CLI
npm install -g @smithery/cli

# 登錄Smithery
smithery login

# 發佈服務器
smithery publish

有關發佈到Smithery.ai的更多信息，請參閱Smithery文檔。

可用資源和工具

資源

工具

交易分析提示

此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文檔可取得顯著更好的效果。

"paradex-docs-mcp": {
   "command": "uvx",
   "args": [
      "--from",
      "mcpdoc",
      "mcpdoc",
      "--urls",
      "Paradex:https://docs.paradex.trade/llms.txt",
      "--transport",
      "stdio"
   ]
}

🔧 技術細節

本項目基於Python 3.10+開發，使用MCP標準實現了與Paradex交易平臺的交互。通過不同的資源和工具接口，為AI助手提供了豐富的交易信息和操作能力。同時，藉助Smithery.ai平臺實現了服務器的發現和部署，方便與Claude Desktop等客戶端集成。

📄 許可證

本項目採用MIT許可證。有關如何為該項目做出貢獻、開發設置和編碼標準的信息，請參閱CONTRIBUTING.md。