MCP Paradex 服务器

概述

MCP Paradex 服务器是一个用于 Paradex 交易平台的模型上下文协议（MCP）服务器实现。它为与 Paradex 平台交互提供了接口和工具。

以下是项目的详细内容：

先决条件

• 操作系统：支持 Linux、macOS 或 Windows。
• Python 版本：需要 Python 3.6 或更高版本。

安装指南

1. 克隆仓库

使用以下命令克隆项目仓库：

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

2. 创建虚拟环境（可选但推荐）

进入项目目录并创建虚拟环境：

cd mcp-paradex-server
python -m venv venv
source venv/bin/activate  # 在 Linux/macOS 上
venv\Scripts\activate      # 在 Windows 上

3. 安装依赖项

安装项目所需的依赖项：

pip install -r requirements.txt

配置

环境变量配置

编辑 .env 文件并添加以下内容：

API_KEY=your_api_key
API_SECRET=your_api_secret
PARADEX_URL=https://api.paradex.com

示例配置文件

.env.example 文件提供了一个配置示例：

DEBUG=True
PORT=8000
DATABASE_URL=sqlite:///db.sqlite3

运行服务器

启动服务器

运行以下命令启动 MCP Paradex 服务器：

python run.py

停止服务器

使用 Ctrl+C 或编写脚本来优雅地关闭服务。

功能概述

系统工具

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

市场工具

• paradex-market-names：获取可用市场列表。
• 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-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：获取保险库交易历史。

开发指南

创建新功能

1. 在 app/ 目录下创建新的路由或服务。
2. 使用 config.py 配置项目参数。

测试

运行单元测试：

pytest tests/

项目结构

• app/：应用程序的主要逻辑。
• config.py：配置文件。
• requirements.txt：依赖项列表。
• run.py：启动脚本。

贡献指南

1. 提交代码前，请确保通过了所有测试。
2. 提交的代码应遵循项目编码规范。
3. 为新功能添加文档和测试。

许可证

本项目采用 MIT License 许可证。