使用说明

项目简介

Paradex MCP服务器是一个基于Model Context Protocol (MCP) 标准构建的应用后端，旨在连接AI助手（如Claude）和Paradex perpetual futures交易平台。它允许AI助手通过标准化的MCP协议，安全、便捷地访问Paradex平台的市场数据，管理交易账户和vaults，并执行交易操作，从而实现智能化的交易策略和自动化。

主要功能点

市场数据访问: 提供实时的Paradex市场数据，包括市场列表、市场信息、订单簿、最近交易等。
账户管理: 支持账户信息查询、持仓 monitoring、交易历史追溯等账户管理功能。
订单管理: 允许AI助手进行订单的创建、取消、状态查询等操作，支持多种订单类型。
Vaults管理: 提供Paradex Vaults相关功能，包括Vaults列表、Vaults详情、余额查询等。
系统状态监控: 提供服务器和Paradex连接状态的健康检查和版本信息查询功能。

安装步骤

本MCP服务器支持多种安装方式，您可以根据自己的需求选择合适的安装方式。

方法一：使用pip (推荐)

克隆仓库:

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

创建并激活虚拟环境:

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

安装依赖:
```
pip install -e .
```

方法二：使用uv (更快)

克隆仓库:

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

创建并激活虚拟环境:

uv venv
source .venv/bin/activate   # Linux/macOS
.venv\Scripts\activate      # Windows

安装依赖:
```
uv pip install -e .
```

服务器配置

MCP客户端（如Claude Desktop）需要配置MCP服务器的启动命令才能连接并使用 Paradex MCP 服务器。配置信息通常在客户端的配置文件中（例如 Claude Desktop 的 'claude_desktop_config.json'）。

以下是 Claude Desktop 的配置示例，您可以参考此示例进行配置：

{
  "mcpServers": {
    "paradex": {
      "command": "uvx",
      "args": ["--with-editable", ".", "mcp-paradex"],
      "env": {
        "PARADEX_ENVIRONMENT": "testnet",
        "PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}

配置参数说明:

server name: 'paradex' (服务器名称，客户端内唯一标识)
command: 'uvx' (服务器启动命令，这里使用 'uvx' 运行，确保虚拟环境已激活)
args: '["--with-editable", ".", "mcp-paradex"]' (启动参数，'--with-editable .' 指定当前目录为可编辑模式，'mcp-paradex' 是 'src/mcp_paradex/main.py' 中定义的入口点)
env: 环境变量配置
- 'PARADEX_ENVIRONMENT': 指定Paradex环境，'testnet' 为测试网，'prod' 为生产网。
- 'PARADEX_ACCOUNT_PRIVATE_KEY': 您的Paradex账户私钥，请务必妥善保管私钥，避免泄露。如果不需要交易功能，可以不配置此项，仅使用公共数据接口。

注意:

请将 'your_private_key' 替换为您实际的Paradex私钥。
如果您使用 'pip' 安装，可以将 'command' 修改为 'python'，'args' 修改为 '["-m", "mcp_paradex"]'。
Docker 部署方式请参考仓库 README 文档。

基本使用方法

配置完成后，在MCP客户端中启用 Paradex MCP 服务器。客户端将通过配置的命令启动服务器并建立连接。

连接成功后，您可以在客户端中使用Paradex MCP服务器提供的 Resources 和 Tools，例如：

查询市场数据: 使用 'market://public/markets' Resource 获取市场列表，或使用 'market://public/info' Resource 获取市场信息。
执行交易操作: 使用 'place_order' Tool 下单，或使用 'cancel_order' Tool 取消订单。
管理Vaults: 使用 'vaults://list' Resource 获取Vaults列表，或使用 'vaults://balance' Resource 查询Vaults余额。

具体可用的 Resources 和 Tools 请参考仓库 README 文档 "Available Resources and Tools" 章节。

关键词