MCP Paradex Server

MCP Paradex Server

一个模型上下文协议服务器的实现,它使 AI 助手能够与 Paradex 永续期货交易平台进行交互,从而可以检索市场数据、管理交易账户、下订单和监控仓位。

远程shell执行
数据库交互
AI集成系统
数据与应用分析
访问服务器

Tools

paradex-account-summary

Get account summary. Returns: Dict[str, Any]: Account summary.

paradex-account-positions

Get account positions. Returns: Dict[str, Any]: Account positions.

paradex-system-config

Get global Paradex system configuration. Retrieves the current system-wide configuration parameters from Paradex, including trading limits, fee schedules, and other global settings. This information is useful for understanding the current operating parameters of the exchange. Returns: Dict[str, Any]: Global Paradex system configuration with the following structure: - exchange (str): Exchange name ("Paradex") - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current environment (mainnet/testnet) - status (str): Current system status ("operational", "maintenance", etc.) - features (List[str]): Available trading features - trading_hours (str): Trading availability - website (str): Exchange website URL - documentation (str): Documentation URL - [Additional system parameters from Paradex API] If an error occurs, returns error information.

paradex-system-time

Get the current Paradex server time. Retrieves the current server time from Paradex. This is important for time-sensitive operations like trading, as local time might differ from the exchange's server time. Using the exchange time ensures accurate timestamp coordination for orders and other time-dependent operations. Returns: Dict[str, Any]: Current server time information with the following structure: - server_time (int): Current server time in milliseconds since epoch - iso_time (str): ISO-formatted timestamp If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message

paradex-system-state

Get the current Paradex system operational state. Retrieves the current operational state of the Paradex exchange, including information about system health, maintenance status, and any active alerts or notices. This is useful for checking if the exchange is fully operational before executing trades. Returns: Dict[str, Any]: Current system state information with the following structure: - status (str): Overall system status ("operational", "degraded", "maintenance", etc.) - components (Dict): Status of individual system components - maintenance (Dict, optional): Information about ongoing or scheduled maintenance - notices (List, optional): System-wide notices or alerts If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message

paradex-vault-list

Get a list of available vaults from Paradex. Retrieves all available vaults on Paradex, including their addresses and names. This tool requires no parameters and returns a comprehensive list of all vaults that can be accessed on Paradex. Returns: Dict[str, Any]: List of available vaults with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - vaults (List[Dict]): List of vault objects with address and name - count (int): Total number of vaults If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - vaults (List): Empty list - count (int): 0

paradex-vault-details

Get detailed information about a specific vault. Retrieves comprehensive details about a specific vault identified by its address, including configuration, permissions, and other vault-specific parameters. Returns: Dict[str, Any]: Detailed vault information with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - vaults (List[Dict]): List containing the vault details - count (int): Number of vaults returned (should be 1) If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - vaults (List): Empty list - count (int): 0

paradex-vaults-config

Get global configuration for vaults from Paradex. Retrieves system-wide configuration parameters for vaults on Paradex, including fee structures, limits, and other global settings that apply to all vaults on the platform. Returns: Dict[str, Any]: Global vault configuration with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - config (Dict): Global vault configuration parameters If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - config (None): Null value for config

paradex-market-names

Get a list of available markets from Paradex. Retrieves all available trading markets/pairs from the Paradex exchange. This tool requires no parameters and returns a comprehensive list of all markets that can be traded on Paradex. Returns: Dict[str, Any]: List of available markets with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - markets (List[str]): List of market symbols - count (int): Total number of markets

paradex-market-details

Get detailed information about a specific market. Retrieves comprehensive details about a specific market, including base and quote assets, tick size, minimum order size, and other trading parameters. Returns: Dict[str, Any]: Detailed market information with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - details (Dict): Detailed market information including trading parameters - error (str, optional): Error message if request failed

paradex-vault-balance

Get the current balance of a specific vault. Retrieves the current balance information for a specific vault, including available funds, locked funds, and total balance. This is essential for understanding the financial state of a vault before executing trades or withdrawals. Returns: Dict[str, Any]: Balance information for the vault, including: - available (float): Available balance that can be used for trading - locked (float): Balance locked in open orders or positions - total (float): Total balance (available + locked) - currency (str): Currency of the balance (e.g., "USDC") If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - balance (None): Null value for balance

paradex-vault-summary

Get a comprehensive summary of a specific vault. Retrieves a summary of all important information about a vault, including balance, positions, recent activity, and performance metrics. This provides a high-level overview of the vault's current state. Returns: Dict[str, Any]: Summary information for the vault, including: - balance (Dict): Current balance information - positions (List): Current open positions - performance (Dict): Performance metrics - recent_activity (List): Recent transactions or trades If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - summary (None): Null value for summary

paradex-vault-transfers

Get a list of deposit and withdrawal transfers for a specific vault. Retrieves the history of all transfers (deposits and withdrawals) for a vault, including timestamps, amounts, transaction hashes, and status information. This is useful for auditing vault activity and tracking fund movements. Returns: Dict[str, Any]: List of transfers for the vault, each containing: - id (str): Transfer ID - type (str): "DEPOSIT" or "WITHDRAWAL" - amount (float): Transfer amount - currency (str): Currency of the transfer - timestamp (str): When the transfer occurred - status (str): Status of the transfer (e.g., "COMPLETED", "PENDING") - transaction_hash (str): Blockchain transaction hash If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - transfers (None): Null value for transfers

paradex-vault-positions

Get a list of current trading positions for a specific vault. Retrieves all open trading positions for a vault, including market, size, entry price, liquidation price, unrealized PnL, and other position-specific information. Returns: Dict[str, Any]: List of positions for the vault, each containing: - market_id (str): Market identifier (e.g., "ETH-PERP") - side (str): Position side ("LONG" or "SHORT") - size (float): Position size - entry_price (float): Average entry price - mark_price (float): Current mark price - liquidation_price (float): Price at which position would be liquidated - unrealized_pnl (float): Unrealized profit/loss - leverage (float): Current leverage If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - positions (None): Null value for positions

paradex-vault-account-summary

Get a summary of trading account information for a specific vault. Retrieves a comprehensive summary of the trading account associated with a vault, including margin information, account health, risk metrics, and trading statistics. Returns: Dict[str, Any]: Account summary information, including: - margin_ratio (float): Current margin ratio - account_health (float): Account health percentage - total_equity (float): Total account equity - available_margin (float): Available margin for new positions - used_margin (float): Margin currently in use - unrealized_pnl (float): Total unrealized profit/loss - realized_pnl_24h (float): Realized profit/loss in the last 24 hours - open_orders_count (int): Number of open orders - positions_count (int): Number of open positions If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - account_summary (None): Null value for account summary

paradex-market-summary

Get a summary of market statistics and current state. Retrieves current market summary information including price, volume, 24h change, and other key market metrics. Returns: Dict[str, Any]: Market summary information including: - Current price - 24h high/low - 24h volume - Price change percentage - Other market statistics If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - summary (None): Null value for summary

paradex-funding-data

Get historical funding rate data for a perpetual market. Retrieves funding rate history for a specified time period, which is essential for understanding the cost of holding perpetual positions. Returns: Dict[str, Any]: Historical funding rate data with timestamps. If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - funding_data (None): Null value for funding data

paradex-bbo

Get the Best Bid and Offer (BBO) for a market. Retrieves the current best bid and best offer (ask) prices and sizes for a specified market. This represents the tightest spread currently available. Returns: Dict[str, Any]: Best bid and offer information including: - bid price and size - ask price and size - timestamp If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message

paradex-orderbook

Get the current orderbook for a market. Retrieves the current state of the orderbook for a specified market, showing bid and ask orders up to the requested depth. Returns: Dict[str, Any]: Orderbook data including: - bids: List of [price, size] pairs - asks: List of [price, size] pairs - timestamp If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - orderbook (None): Null value for orderbook

paradex-klines

Get candlestick (kline) data for a market. Retrieves historical price candlestick data for a specified market and time period. Each candlestick contains open, high, low, close prices and volume information. Returns: Dict[str, Any]: Candlestick data with the following structure for each candle: - timestamp - open price - high price - low price - close price - volume If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message

paradex-trades

Get recent trades for a market. Retrieves historical trade data for a specified market and time period. Each trade includes price, size, side (buy/sell), and timestamp information. Returns: Dict[str, Any]: List of trades with the following structure for each trade: - id: Trade ID - price: Execution price - size: Trade size - side: "buy" or "sell" - timestamp: Time of execution If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message

paradex-account-fills

Get account fills. Returns: Dict: Account fills.

paradex-account-funding-payments

Get account funding payments. Returns: Dict[str, Any]: Account funding payments.

paradex-account-open-orders

Get account open orders. Returns: Dict[str, Any]: Account orders.

paradex-create-order

Create a new order. Returns: Dict[str, Any]: Created order details.

paradex-cancel-order

Cancel an order. Returns: Dict[str, Any]: Cancelled order details.

paradex-cancel-all-orders

Cancel all orders.

paradex-get-order-status

Get order status. Returns: Dict[str, Any]: Order details.

README

MCP Paradex 服务器

smithery badge

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

概述

此项目提供了一个 AI 助手(如 Claude)和 Paradex 永续期货交易平台之间的桥梁。 使用 MCP 标准,AI 助手可以:

  • 从 Paradex 检索市场数据
  • 管理交易账户和金库
  • 下单和管理订单
  • 监控仓位和余额

前提条件

  • Python 3.10+

安装

通过 Smithery 安装

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

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
    
  2. 创建一个虚拟环境:

    python -m venv .venv
    source .venv/bin/activate  # 在 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  # 在 Windows 上: .venv\Scripts\activate
    
  3. 安装依赖项:

    uv pip install -e .
    

配置

设置您的配置:

cp .env.template .env

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

运行服务器

Docker (推荐)

docker build . -t sv/mcp-paradex-py

在 Cursor 中添加 MCP 作为命令

仅公开

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 兼容,Smithery.ai 是一个用于发现和部署 MCP 服务器的平台。

Claude Desktop 配置

要通过 Smithery.ai 将此服务器与 Claude Desktop 一起使用:

  1. 打开 Claude Desktop 并从菜单启用开发者模式
  2. 转到设置 > 开发者并单击“编辑配置”
  3. 将以下配置添加到您的 claude_desktop_config.json
{
  "mcpServers": {
    "paradex": {
      "command": "uvx",
      "args": ["--with-editable", ".", "mcp-paradex"],
      "env": {
        "PARADEX_ENVIRONMENT": "testnet",
        "PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}
  1. your_ethereum_private_key 替换为您实际的 Paradex 私钥
  2. 保存文件并重新启动 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 文档

可用资源和工具

资源

系统资源

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

市场资源

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

金库资源

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

工具

系统工具

  • 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 - 获取金库的账户摘要

贡献

请参阅 CONTRIBUTING.md 以获取有关如何为此项目做出贡献、开发设置和我们的编码标准的信息。

许可证

MIT 许可证

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。

官方
精选
TypeScript
VeyraX

VeyraX

一个单一的 MCP 工具,连接你所有喜爱的工具:Gmail、日历以及其他 40 多个工具。

官方
精选
本地
e2b-mcp-server

e2b-mcp-server

使用 MCP 通过 e2b 运行代码。

官方
精选
Neon MCP Server

Neon MCP Server

用于与 Neon 管理 API 和数据库交互的 MCP 服务器

官方
精选
Exa MCP Server

Exa MCP Server

模型上下文协议(MCP)服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。

官方
精选
mcp-server-qdrant

mcp-server-qdrant

这个仓库展示了如何为向量搜索引擎 Qdrant 创建一个 MCP (Managed Control Plane) 服务器的示例。

官方
精选
AIO-MCP Server

AIO-MCP Server

🚀 集成了 AI 搜索、RAG 和多服务(GitLab/Jira/Confluence/YouTube)的一体化 MCP 服务器,旨在增强 AI 驱动的开发工作流程。来自 Folk。

精选
本地
Knowledge Graph Memory Server

Knowledge Graph Memory Server

为 Claude 实现持久性记忆,使用本地知识图谱,允许 AI 记住用户的信息,并可在自定义位置存储,跨对话保持记忆。

精选
本地
Hyperbrowser

Hyperbrowser

欢迎来到 Hyperbrowser,人工智能的互联网。Hyperbrowser 是下一代平台,旨在增强人工智能代理的能力,并实现轻松、可扩展的浏览器自动化。它专为人工智能开发者打造,消除了本地基础设施和性能瓶颈带来的麻烦,让您能够:

精选
本地
https://github.com/Streen9/react-mcp

https://github.com/Streen9/react-mcp

react-mcp 与 Claude Desktop 集成,能够根据用户提示创建和修改 React 应用程序。

精选
本地