MCP Paradex Server

基本能力

产品定位

MCP Paradex Server 是一个连接 AI 助手与 Paradex 交易平台的桥梁，专注于提供金融交易相关的功能。

核心功能

• 获取 Paradex 的市场数据
• 管理交易账户和金库
• 下单和管理订单
• 监控持仓和余额

适用场景

• AI 助手辅助交易
• 自动化交易策略执行
• 实时市场数据监控

工具列表

系统工具

• paradex-system-config: 获取全局 Paradex 系统配置
• paradex-system-time: 获取当前 Paradex 服务器时间
• paradex-system-state: 获取当前系统状态

市场工具

• paradex-market-names: 获取 Paradex 可用市场列表
• paradex-market-details: 获取特定市场的详细信息
• paradex-market-summaries: 获取所有市场或特定市场的摘要
• paradex-funding-data: 获取市场的资金费率数据
• paradex-orderbook: 获取市场的当前订单簿
• paradex-klines: 获取市场的历史 K 线数据
• paradex-trades: 获取市场的最近交易
• paradex-bbo: 获取市场的最佳买卖报价

账户工具

• paradex-account-summary: 获取账户摘要信息
• paradex-account-positions: 获取当前账户持仓
• paradex-account-fills: 获取账户交易记录
• paradex-account-funding-payments: 获取账户资金支付
• paradex-account-transactions: 获取账户交易历史

订单工具

• paradex-account-open-orders: 获取账户所有未平仓订单
• paradex-create-order: 在 Paradex 上下新订单
• paradex-cancel-order: 取消现有订单
• paradex-cancel-order-by-client-id: 通过客户端 ID 取消订单
• paradex-cancel-all-orders: 取消所有未平仓订单
• paradex-get-order-status: 获取订单状态
• paradex-get-order-by-client-id: 通过客户端 ID 获取订单状态
• paradex-get-orders-history: 获取账户的历史订单

金库工具

• paradex-vault-list: 列出所有可用金库
• paradex-vault-details: 获取金库的详细信息
• paradex-vaults-config: 获取金库配置选项
• paradex-vault-balance: 获取金库的余额
• paradex-vault-summary: 获取金库状态的摘要
• paradex-vault-transfers: 获取金库的转账历史
• paradex-vault-positions: 获取金库的当前持仓
• paradex-vault-account-summary: 获取金库的账户摘要

常见问题解答

• 如何配置 Paradex 凭证？ 编辑 .env 文件并填入您的 Paradex 凭证。
• 如何与 Claude Desktop 集成？ 在 Claude Desktop 的开发者设置中添加 MCP 服务器配置。
• 如何发布到 Smithery.ai？ 使用 Smithery CLI 登录并发布服务器。

使用教程

使用依赖

• Python 3.10+

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @sv/mcp-paradex-py --client claude

使用 pip 安装

1. 克隆仓库

git clone https://github.com/sv/mcp-paradex-py.git
cd mcp-paradex-py

1. 创建虚拟环境

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

1. 安装依赖

pip install -e .

使用 uv 安装（更快）

1. 克隆仓库

git clone https://github.com/sv/mcp-paradex-py.git
cd mcp-paradex-py

1. 创建虚拟环境

uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

1. 安装依赖

uv pip install -e .

配置

cp .env.template .env

然后编辑 .env 文件填入您的 Paradex 凭证。

运行服务器

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

调试方式

• 检查系统状态

curl http://localhost:8080/system/status

• 检查市场数据

curl http://localhost:8080/market/public/markets

• 检查账户信息

curl http://localhost:8080/vaults/list

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。