Paradex Trading

MCP Paradex Server

Paradex 交易平台的 Model Context Protocol（MCP）服务实现。

快速入门

初次使用？请参阅 快速入门指南，了解如何逐步为 Claude Desktop、Claude Code、Cursor、Windsurf、VS Code、Claude.ai 网页版和 ChatGPT 进行设置。

需要用于 ChatGPT 或 Claude.ai 网页版的远程 HTTP 端点？请参阅 HTTP 部署指南，了解 Railway、Render、Fly.io、AWS Lambda 和 Docker/VPS 选项。

概览

本项目为 AI 助手（如 Claude）与 Paradex 之间提供桥接。Paradex 是一个基于 Starknet、保护隐私的多资产交易所，提供现货、永续合约、期权和大宗商品期货。借助 MCP 标准，AI 助手可以：

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

前提条件

• Python 3.10+

• uv — 使用 uvx 运行方式时必需

  macOS： 通过 brew install uv 安装，以便将二进制文件放入 /usr/local/bin，供 Claude Desktop 等图形应用查找。通过 curl 管道安装会将 uv 放入 ~/.local/bin，图形应用无法访问此目录。

安装

快速开始

Cursor IDE

点击即可在 Cursor 中自动配置此 MCP 服务：

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 账户私钥

签名者模式（无需私钥）

若要通过持有密钥的签名代理进行交易，请设置以下四项，并将 PARADEX_ACCOUNT_PRIVATE_KEY 留空：

• PARADEX_SIGNER_HEADER：服务端用于放置每条消息哈希的标头，采用 base64 编码
• PARADEX_SIGNER_SIGNATURE：服务端发送的占位签名，供代理替换
• PARADEX_ACCOUNT_ADDRESS：你的 Paradex 账户地址
• PARADEX_ACCOUNT_PUBLIC_KEY：代理用于签名的密钥的公钥

缺少上述任一项时，每次工具调用都会返回配置错误。如果同时设置了私钥，服务端仍会使用签名者模式，并记录一条警告。签名者模式下无法使用大宗交易工具。

出站代理

设置 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）

使用 Dockerfile.aws，通过 Lambda Web Adapter 在 AWS Lambda 上进行远程部署。 该适配器会将 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 - 获取历史 K 线数据
• 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 - 互动式交易建议与咨询

Documentation MCP

通过访问 Paradex 文档增强结果：

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

贡献

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

许可证

MIT 许可证