MCP Paradex Server

MCP Paradex 服务器

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

概述

该项目在人工智能助手（例如 Claude）和 Paradex 永续期货交易平台之间架起了一座桥梁。使用 MCP 标准，人工智能助手可以：

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

先决条件

• Python 3.10+

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 mcp-paradex-py：

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

1. 克隆此存储库：
   git clone https://github.com/sv/mcp-paradex-py.git cd mcp-paradex-py
2. 创建虚拟环境：
   uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. 安装依赖项：

配置

设置您的配置：

然后使用您的 Paradex 凭证编辑.env文件。

运行服务器

Docker（推荐）

在 Cursor 中添加 MCP 作为命令

仅限公众

允许交易

Smithery.ai 集成

该 MCP 服务器与Smithery.ai兼容，后者是一个用于发现和部署 MCP 服务器的平台。

Claude桌面配置

要通过 Smithery.ai 将此服务器与 Claude Desktop 一起使用：

1. 打开 Claude Desktop 并从菜单中启用开发者模式
2. 前往“设置”>“开发者”，然后点击“编辑配置”
3. 将以下配置添加到您的claude_desktop_config.json ：

4. 用您的实际 Paradex 私钥替换your_ethereum_private_key
5. 保存文件并重新启动Claude Desktop

Smithery.ai 注册中心

该服务器包含一个smithery.yaml文件，其中包含 Smithery.ai 注册表的元数据。如果您想将此服务器发布到 Smithery.ai，可以使用 Smithery CLI：

有关发布到 Smithery.ai 的更多信息，请参阅Smithery 文档。

可用资源和工具

资源

系统资源

• paradex://system/config - 获取 Paradex 系统配置和交易所的基本信息
• paradex://system/time - 获取当前系统时间（自纪元以来的毫秒数）
• paradex://system/state - 获取当前 Paradex 系统运行状态

市场资源

• paradex://markets - 从 Paradex 获取可用市场列表
• paradex://market/summary/{market_id} - 获取特定交易对的详细市场信息

Vault 资源

• paradex://vaults - 列出 Paradex 上所有可用的 vaults
• paradex://vaults/config - 获取 vaults 的全局配置
• 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 系统配置
• paradex_system_state - 获取当前系统状态

市场工具

• paradex_markets - 获取有关市场的详细信息，包括基准/报价资产、最小报价单位和其他交易参数
• paradex_market_summaries - 获取价格、交易量、24 小时变化和其他关键市场指标的摘要
• paradex_funding_data - 获取永久市场的历史融资利率数据
• paradex_orderbook - 获取具有可自定义深度的市场的当前订单簿
• paradex_klines - 获取市场的历史烛台（OHLCV）数据
• 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 上创建新订单
• 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 - 获取保险库的交易账户信息，包括保证金和风险指标

交易分析提示

该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 文档，我们看到了明显更好的效果。

贡献

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

执照

MIT 许可证