AI导哈

交易平台MCP服务

为Paradex永续期货交易平台提供AI助手与交易系统之间的桥接服务，支持市场数据获取、账户管理、订单操作等功能。

  • by sv
  • Python
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 sv/mcp-paradex-py

使用说明

MCP Paradex服务器

您可以在此处找到最新的支持版本https://github.com/tradeparadex/mcp-paradex-py

Paradex交易平台的模型上下文协议（MCP）服务器实现。

概述

该项目在人工智能助手（如克劳德）和 Paradex永久期货交易平台。使用MCP标准， AI助手可以：

  • 从Paradex检索市场数据
  • 管理交易账户和金库
  • 下达和管理订单
  • 监控位置和平衡

先决条件

  • Python 3.10+

安装

快速开始

Cursor 集成开发环境

单击以在游标中自动配置此MCP服务器：

克劳德代码CLI

claude mcp add paradex uvx mcp-paradex

史密瑟里（克劳德桌面）

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：设置为 prod, testnet，或 nightly （默认值： prod)
  • PARADEX_ACCOUNT_PRIVATE_KEY：您的Paradex帐户私钥

使用.env文件

cp .env.template .env
# Edit .env with your credentials

客户端配置

克劳德桌面

添加到您的 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 sv/mcp-paradex-py

# Run (public only)
docker run --rm -i sv/mcp-paradex-py

# Run with trading capabilities
docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=your_key -i sv/mcp-paradex-py

Docker（AWS Lambda/HTTP）

使用 Dockerfile.aws 通过AWS Lambda进行远程部署 Lambda Web适配器. 适配器将Lambda调用桥接到服务器的HTTP端点， 因此不需要特定于Lambda的代码。

# Build
docker build -f Dockerfile.aws -t sv/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 \
  sv/mcp-paradex-py-aws

服务器将在以下时间可用 http://localhost:8080/mcp.

部署到Lambda：

  1. 将图像推送到ECR
  2. 从容器映像创建Lambda函数
  3. 将Lambda函数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} -详细的市场信息

保险库资源

  • 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 -获取历史订单

Vault工具

  • 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"
   ]
}

贡献

请看 贡献.md 了解如何 为这个项目、开发设置和我们的编码标准做出贡献。

许可证

MIT许可证

相关 MCP