🚀 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（更快的替代方法）
- 克隆此仓库：
git clone https://github.com/sv/mcp-paradex-py.git
cd mcp-paradex-py
- 创建虚拟环境：
uv venv
source .venv/bin/activate # 在Windows上：.venv\Scripts\activate
- 安装依赖：
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中使用此服务器，可按以下步骤操作：
- 打开Claude Desktop，从菜单中启用开发者模式。
- 转到“设置”>“开发者”，点击“编辑配置”。
- 在
claude_desktop_config.json中添加以下配置：
{
"mcpServers": {
"paradex": {
"command": "uvx",
"args": ["--with-editable", ".", "mcp-paradex"],
"env": {
"PARADEX_ENVIRONMENT": "testnet",
"PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
}
}
}
}
- 将
your_ethereum_private_key替换为你实际的Paradex私钥。 - 保存文件并重启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文档。
可用资源和工具
资源
| 属性 | 详情 |
|---|---|
| 系统资源 | paradex://system/config：获取Paradex系统配置和交易所基本信息；paradex://system/time：获取自纪元以来的当前系统时间（以毫秒为单位）；paradex://system/state：获取当前Paradex系统的运行状态 |
| 市场资源 | paradex://markets：获取Paradex上可用市场的列表；paradex://market/summary/{market_id}：获取特定交易对的详细市场信息 |
| 金库资源 | paradex://vaults：列出Paradex上所有可用的金库；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系统配置 |
| 系统工具 | paradex_system_state |
获取当前系统状态 |
| 市场工具 | paradex_markets |
获取市场的详细信息，包括基础/报价资产、点差大小和其他交易参数 |
| 市场工具 | paradex_market_summaries |
获取包含价格、成交量、24小时变化和其他关键市场指标的摘要 |
| 市场工具 | paradex_funding_data |
获取永续市场的历史资金费率数据 |
| 市场工具 | paradex_orderbook |
获取市场的当前订单簿，深度可定制 |
| 市场工具 | paradex_klines |
获取市场的历史K线（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 |
获取账户的历史订单 |
| 金库工具 | 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文档可取得显著更好的效果。
"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。