MCP Paradex 服务器

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

概述

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

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

先决条件

• Python 3.10+

安装

通过 Smithery 安装

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

使用 pip

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

使用 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. 安装依赖项：
   uv pip install -e .

配置

设置您的配置：

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

运行服务器

Docker（推荐）

在光标处添加 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 文档。

可用资源和工具

资源

系统资源

• system://status - 获取系统和 Paradex 连接的当前状态
• system://version - 获取有关服务器和依赖项的详细版本信息
• system://health - 执行服务器的基本健康检查

市场资源

• market://public/markets - 从 Paradex 获取可用市场列表
• market://public/info - 获取一般市场信息和状态

Vault 资源

• vaults://list - 列出与帐户关联的所有保管库
• vaults://balance - 获取特定保险库的余额
• vaults://details - 获取有关保险库的详细信息

工具

系统工具

• 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 - 获取保险库的交易账户信息，包括保证金和风险指标

贡献

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

执照

MIT 许可证