MCP Paradex Server
一个模型上下文协议服务器的实现,它使 AI 助手能够与 Paradex 永续期货交易平台进行交互,从而可以检索市场数据、管理交易账户、下订单和监控仓位。
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 服务器
用于 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
-
克隆此存储库:
git clone https://github.com/sv/mcp-paradex-py.git cd mcp-paradex-py
-
创建一个虚拟环境:
python -m venv .venv source .venv/bin/activate # 在 Windows 上: .venv\Scripts\activate
-
安装依赖项:
pip install -e .
使用 uv (更快的替代方案)
-
克隆此存储库:
git clone https://github.com/sv/mcp-paradex-py.git cd mcp-paradex-py
-
创建一个虚拟环境:
uv venv source .venv/bin/activate # 在 Windows 上: .venv\Scripts\activate
-
安装依赖项:
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 一起使用:
- 打开 Claude Desktop 并从菜单启用开发者模式
- 转到设置 > 开发者并单击“编辑配置”
- 将以下配置添加到您的
claude_desktop_config.json
:
{
"mcpServers": {
"paradex": {
"command": "uvx",
"args": ["--with-editable", ".", "mcp-paradex"],
"env": {
"PARADEX_ENVIRONMENT": "testnet",
"PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
}
}
}
}
- 将
your_ethereum_private_key
替换为您实际的 Paradex 私钥 - 保存文件并重新启动 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 以获取有关如何为此项目做出贡献、开发设置和我们的编码标准的信息。
许可证
推荐服务器
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。

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

e2b-mcp-server
使用 MCP 通过 e2b 运行代码。
Neon MCP Server
用于与 Neon 管理 API 和数据库交互的 MCP 服务器
Exa MCP Server
模型上下文协议(MCP)服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。
mcp-server-qdrant
这个仓库展示了如何为向量搜索引擎 Qdrant 创建一个 MCP (Managed Control Plane) 服务器的示例。
AIO-MCP Server
🚀 集成了 AI 搜索、RAG 和多服务(GitLab/Jira/Confluence/YouTube)的一体化 MCP 服务器,旨在增强 AI 驱动的开发工作流程。来自 Folk。
Knowledge Graph Memory Server
为 Claude 实现持久性记忆,使用本地知识图谱,允许 AI 记住用户的信息,并可在自定义位置存储,跨对话保持记忆。
Hyperbrowser
欢迎来到 Hyperbrowser,人工智能的互联网。Hyperbrowser 是下一代平台,旨在增强人工智能代理的能力,并实现轻松、可扩展的浏览器自动化。它专为人工智能开发者打造,消除了本地基础设施和性能瓶颈带来的麻烦,让您能够:
https://github.com/Streen9/react-mcp
react-mcp 与 Claude Desktop 集成,能够根据用户提示创建和修改 React 应用程序。