MCP Paradex服务器
Paradex交易平台的模型上下文协议（MCP）服务器实现。
概述
该项目在人工智能助手（如克劳德）和 Paradex永久期货交易平台。使用MCP标准， AI助手可以：
- 从Paradex检索市场数据
- 管理交易账户和金库
- 下达和管理订单
- 监控位置和平衡
先决条件
- Python 3.10+
安装
快速开始
光标IDE
单击以在游标中自动配置此MCP服务器：
Claude 代码命令行界面
claude mcp add paradex uvx mcp-paradex史密瑟里（克劳德桌面）
npx -y @smithery/cli install @sv/mcp-paradex-py --client claude标准安装
PyPI
pip install mcp-paradexuvx（推荐）
uvx mcp-paradex开发环境
- 克隆存储库：
git clone https://github.com/sv/mcp-paradex-py.git
cd mcp-paradex-py- 安装开发依赖项：
uv sync --dev --all-extras- 在本地运行：
uv run mcp-paradex配置
环境变量
为身份验证设置以下环境变量：
PARADEX_ENVIRONMENT：设置为prod,testnet，或nightly（默认值：prod)PARADEX_ACCOUNT_PRIVATE_KEY：您的Paradex帐户私钥
使用.env文件
cp .env.template .env
# Edit .env with your credentials客户端配置
克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"paradex": {
"command": "uvx",
"args": ["mcp-paradex"],
"env": {
"PARADEX_ENVIRONMENT": "testnet",
"PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
}
}
}
}Docker（本地/stdio）
# Build image
docker build . -t sv/mcp-paradex-py
# Run (public only)
docker run --rm -i sv/mcp-paradex-py
# Run with trading capabilities
docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=your_key -i sv/mcp-paradex-pyDocker（AWS Lambda/HTTP）
使用 Dockerfile.aws 通过AWS Lambda进行远程部署 Lambda Web适配器. 适配器将Lambda调用桥接到服务器的HTTP端点， 因此不需要特定于Lambda的代码。
# Build
docker build -f Dockerfile.aws -t sv/mcp-paradex-py-aws .
# Test locally (mirrors Lambda config)
docker run --rm -p 8080:8080 \
-e MCP_TRANSPORT=streamable-http \
-e MCP_STATELESS=true \
-e MCP_PORT=8080 \
-e PARADEX_ENVIRONMENT=prod \
sv/mcp-paradex-py-aws服务器将在以下时间可用 http://localhost:8080/mcp.
部署到Lambda：
- 将图像推送到ECR
- 从容器映像创建Lambda函数
- 将Lambda函数URL调用模式设置为
RESPONSE_STREAM - 在Lambda函数上设置环境变量：
- MCP_TRANSPORT=streamable-http - MCP_STATELESS=true - PARADEX_ENVIRONMENT=prod （或 testnet) - PARADEX_ACCOUNT_PRIVATE_KEY=your_key （可选，用于交易）
可用资源和工具
资源
系统资源
paradex://system/config-获取Paradex系统配置paradex://system/time-获取当前系统时间paradex://system/state-获取系统运行状态
市场资源
paradex://markets-可用市场列表paradex://market/summary/{market_id}-详细的市场信息
保险库资源
paradex://vaults-列出所有保险库paradex://vaults/config-全局保险库配置paradex://vaults/balance/{vault_id}-保险库余额paradex://vaults/summary/{vault_id}-全面的保险库摘要paradex://vaults/transfers/{vault_id}-存款/取款历史paradex://vaults/positions/{vault_id}-当前交易头寸paradex://vaults/account-summary/{vault_id}-交易账户信息
工具
系统工具
paradex_system_config-获取全局系统配置paradex_system_state-获取当前系统状态
市场工具
paradex_markets-获取详细的市场信息paradex_market_summaries-获取包含指标的市场摘要paradex_funding_data-获取历史融资率数据paradex_orderbook-获取具有可定制深度的当前订单paradex_klines-获取历史烛台数据paradex_trades-获取最近的交易paradex_bbo-获得最佳出价和报价
帐户工具
paradex_account_summary-获取帐户摘要paradex_account_positions-获取当前职位paradex_account_fills-获取交易填充paradex_account_funding_payments-获得资金支付paradex_account_transactions-获取交易历史记录
订购工具
paradex_open_orders-获取所有未结订单paradex_create_order-创建新订单paradex_cancel_orders-取消现有订单paradex_order_status-获取订单状态paradex_orders_history-获取历史订单
Vault工具
paradex_vaults-获取详细的保险库信息paradex_vaults_config-获取全局保险库配置paradex_vault_balance-获取保险库余额paradex_vault_summary-获取全面的保险库摘要paradex_vault_transfers-获取存款/取款历史记录paradex_vault_positions-获取当前保险库位置paradex_vault_account_summary-获取保险库交易账户信息
交易分析提示
市场分析
market_overview-全面的加密货币市场概述market_analysis-详细的技术和微观结构分析
职位和投资组合管理
position_management-综合头寸分析create_optimal_order-设计最优订单参数hedging_strategy-制定有效的对冲策略portfolio_risk_assessment-全面的投资组合风险分析liquidation_protection-识别并降低清算风险
投资策略
vault_analysis-用于投资决策的全面保险库分析funding_rate_opportunity-识别融资利率套利机会trading_consultation-互动式交易建议和咨询
文档MCP
通过Paradex文档访问增强结果：
"paradex-docs-mcp": {
"command": "uvx",
"args": [
"--from",
"mcpdoc",
"mcpdoc",
"--urls",
"Paradex:https://docs.paradex.trade/llms.txt",
"--transport",
"stdio"
]
}贡献
请参阅 贡献.md 了解如何 为这个项目、开发设置和我们的编码标准做出贡献。