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。