MCP Paradex 服务器

这是用于 Paradex 交易平台的 Model Context Protocol (MCP) 服务器实现。

<a href="https://glama.ai/mcp/servers/cq4bz5ljqj"> <img width="380" height="200" src="https://gips2.baidu.com/it/u=3184337242,1819570068&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Paradex Server MCP 服务器" /> </a>

概述

该项目提供了一个桥梁，连接 AI 助手（如 Claude）与 Paradex 永续期货交易平台。使用 MCP 标准，AI 助手可以：

• 从 Paradex 获取市场数据
• 管理交易账户和金库
• 下单和管理订单
• 监控仓位和余额

预备条件

• Python 3.10+

安装

快速开始

Cursor IDE

点击以自动配置此 MCP 服务器在 Cursor 中：

Claude Code CLI

claude mcp add paradex uvx mcp-paradex

Smithery (Claude Desktop)

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

标准安装

PyPI

pip install mcp-paradex

uvx (推荐)

uvx mcp-paradex

开发环境设置

1. 克隆仓库：

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

2. 安装开发依赖项：

   uv sync --dev --all-extras
   

3. 本地运行：

   uv run mcp-paradex
   

配置

环境变量

设置这些环境变量进行身份验证：

• PARADEX_ENVIRONMENT：设置为 testnet 或 mainnet
• PARADEX_ACCOUNT_PRIVATE_KEY：你的 Paradex 账户私钥

使用 .env 文件

cp .env.template .env
# 编辑 .env 文件并添加你的凭据

客户端配置

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

# 构建镜像
docker build . -t sv/mcp-paradex-py

# 运行（仅限公开）
docker run --rm -i sv/mcp-paradex-py

# 带有交易功能运行
docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=your_key -i sv/mcp-paradex-py

可用资源和工具

资源

系统资源

• paradex://system/config - 获取 Paradex 系统配置
• paradex://system/time - 获取当前系统时间
• paradex://system/state - 获取系统操作状态

市场资源

• paradex://markets - 可用市场的列表
• paradex://market/summary/{market_id} - 详细的市场信息

金库资源

• paradex://vaults - 列出所有金库
• paradex://vaults/config - 全局金库配置
• paradex://vaults/balance/{vault_id} - 金库余额
• paradex://vaults/summary/{vault_id} - 综合金库概要
• 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 - 获取历史订单

金库工具

• paradex_vaults - 获取详细金库信息
• paradex_vaults_config - 获取全局金库配置
• paradex_vault_balance - 获取金库余额
• paradex_vault_summary - 获取综合金库概要
• paradex_vault_transfers - 获取存款/取款历史
• paradex_vault_positions - 获取当前金库仓位
• paradex_vault_account_summary - 获取金库交易账户信息

交易分析提示

市场分析

• market_overview - 综合加密货币市场概述
• market_analysis - 详细的市场技术和微观结构分析

仓位和投资组合管理

• position_management - 综合仓位分析
• create_optimal_order - 设计最优订单参数
• hedging_strategy - 开发有效的对冲策略
• portfolio_risk_assessment - 投资组合风险的彻底分析
• 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"
   ]
}

贡献

请参阅 CONTRIBUTING.md 了解如何为此项目做出贡献、开发环境设置以及我们的编码标准。

许可证

MIT 许可证