阿尔法竞技场MCP
概述
Alpha Arena MCP将AI模型与Hyperliquit永久期货交易所连接起来，使LLM能够：
- 分析实时市场数据（价格、指标、未平仓合约）。
- 获取并格式化账户头寸和绩效。
- 使用风险管理订单执行交易（包括自动计算的止盈/止损）。
- 以编程方式关闭头寸或取消订单。
该服务器专为算法交易机器人而设计，支持主网和测试网操作。它使用CCXT库进行交换交互，使用pandas_ta进行技术分析。
关键用例：与Claude Desktop或类似的MCP客户端集成，创建一个AI交易助手，根据提示生成建议并通过工具执行。
特性
- 交易工具:
- 使用杠杆TP/SL下达限价/市价订单（如果省略，则自动计算）。 - 关闭某个交易品种的所有头寸（仅减少市价单）。 - 取消某个交易品种的所有未结订单。 - 检索格式化的账户信息（余额、头寸、PnL）。 - 获取格式化的市场状态（OHLCV、EMA、MACD、RSI、交易量、OI、资金利率）。
- MCP提示:
- 专家密码分析的系统提示。 - 用户提示模板，其中包含LLM调用的市场/账户数据。
- Exchange支持：超级液体永久（沙箱/测试网可配置）。
- 风险管理：基于杠杆的内置TP/SL计算（2:1回报：风险比）。
- 错误处理：API错误的优雅后退。
先决条件
- Python 3.10+
- 紫外线 用于依赖关系管理（推荐；回退到pip）
- 具有API凭证（钱包地址和私钥）的Hyperliquid帐户。
安装
- 克隆存储库:
git clone https://github.com/kukapay/alpha-arena-mcp.git
cd alpha-arena-mcp- 使用uv安装依赖项：
uv sync - 安装到Claude桌面：
将服务器安装为Claude Desktop应用程序：
uv run mcp install main.py --name "Alpha Arena"配置文件作为参考：
{
"mcpServers": {
"Alpha Arena": {
"command": "uv",
"args": [ "--directory", "/path/to/alpha-arena-mcp", "run", "main.py" ],
"env": {
"MAIN_ACCOUNT_ADDRESS": "your_main_account_address",
"API_ACCOUNT_PRIVATE_KEY": "your_api_account_private_key",
"NETWORK": "testnet" /* testnet | main */
}
}
}
}将/path/to/alpha arena-mcp替换为您的实际安装路径，并用您自己的帐户详细信息更新your_min_account_address和your_ai_account_private_key。
用法
工作流示例
- 设置分析 （通过提示）：
- 使用 nof1_system_prompt() 加载专家交易员角色。
- 生成推荐 （通过提示+数据）：
- 使用 nof1_user_prompt("BTC/USDC:USDC") → 将市场/账户数据注入用户提示，以进行LLM分析。
- 执行交易 （通过工具）：
- place_order(symbol="BTC/USDC:USDC", side="buy", size=0.01, leverage=10) → 使用自动TP/SL下订单。
- 管理职位:
- close_position("BTC/USDC:USDC") → 关闭所有头寸。 - cancel_open_orders("BTC/USDC:USDC") → 取消待处理订单。
可用工具
下单
使用可选的TP/SL下达限价/市价订单。如果没有提供，则根据杠杆率自动计算TP/SL（2:1回报：风险）。
参数:
symbol（str）：交易对，例如“BTC/USDC:USDC”。side（str：买入/卖出）：订单方向。size（浮动）：订单大小（数量）。price（浮动，可选）：限价（默认为当前市场价格）。leverage（浮点数=10）：杠杆倍数。tp_price/sl_price（浮动，可选）：获利/止损价格。
退货：Dict:订单ID或错误。
用法示例
提示：
使用市场价格在Hyperliquit上以10倍杠杆购买0.01 BTC。
答复：
{
"status": "success",
"result": {
"main_order_id": "abc123",
"tp_order_id": "def456",
"sl_order_id": "ghi789",
"status": "success"
}
}闭合位置
使用只减市价单关闭某个交易品种的所有头寸。
参数:
symbol（str）：交易对，例如“BTC/USDC:USDC”。
退货：骰子：关闭订单或无操作消息。
用法示例
提示：
立即关闭我的全部BTC头寸。
答复：
{
"close_orders": [
{
"order_id": "jkl012",
"side": "sell",
"size": 0.01,
"status": "closed"
}
],
"status": "success"
}取消订单
取消某个交易品种的所有未结订单。
参数:
symbol（str）：交易对，例如“ETH/USDC:USDC”。
退货：骰子：订单取消或无操作消息。
用法示例
提示：
取消我所有的ETH挂单。
答复：
{
"canceled_orders": [
{
"id": "mno345",
"status": "canceled"
},
{
"id": "pqr678",
"status": "canceled"
}
],
"status": "success"
}account_info
获取并格式化账户余额、头寸和绩效摘要。
参数：没有。
退货：str：已格式化的帐户摘要。
用法示例
提示：
我目前的账户状态如何？
答复：
Current Total Return (percent): 2.5%
Available Cash: 1500.0
Current Account Value: 1525.0
Positions: {"symbol": "BTC/USDC:USDC", "quantity": 0.01, "unrealized_pnl": 25.0, ...}市场状态
获取和格式化市场数据，包括技术指标、交易量、未平仓合约和融资率。
参数:
symbol（str）：交易对，例如“SOL/USDC:USDC”。
退货：str：形成的市场状态。
用法示例
提示：
给我SOL的最新市场数据。
答复：
Current Market State:
current_price = 150.25, current_ema20 = 148.50, current_macd = 1.20, current_rsi (7 period) = 65.3
Open Interest: Latest: 100000.0 Average: 100000.0
Funding Rate: 0.0001
Intraday series (by minute, oldest → latest):
Mid prices: [145.0, 146.2, ...]
...可用提示
nof1_system_prompt
专家加密分析师系统提示。
参数：无\ 退货：str：系统消息。
示例:
You are an expert cryptocurrency analyst and trader with deep knowledge of blockchain technology, market dynamics, and technical analysis.
Your role is to:
- Analyze cryptocurrency market data, including price movements, trading volumes, and market sentiment
- Evaluate technical indicators such as RSI, MACD, moving averages, and support/resistance levels
- Consider fundamental factors like project developments, adoption rates, regulatory news, and market trends
- Assess risk factors and market volatility specific to cryptocurrency markets
- Provide clear trading recommendations (BUY, SELL, or HOLD) with detailed reasoning
- Suggest entry and exit points, stop-loss levels, and position sizing when appropriate
- Stay objective and data-driven in your analysis
[... full prompt continues ...]
Today is November 01, 2025.nof1_user_prompt
数据丰富的用户分析提示。
参数: symbol （str）\ 退货：str：提示市场/账户数据。
It has been 45 minutes since you started trading. The current time is 2025-11-01T10:30:00 and you've been invoked 3 times. Below, we are providing you with a variety of state data, price data, and predictive signals so you can discover alpha. Below that is your current account information, value, performance, positions, etc.
ALL OF THE PRICE OR SIGNAL DATA BELOW IS ORDERED: OLDEST → NEWEST
Timeframes note: Unless stated otherwise in a section title, intraday series are provided at 3-minute intervals. If a coin uses a different interval, it is explicitly stated in that coin's section.
# HERE IS THE CURRENT MARKET STATE
## ALL SOL DATA FOR YOU TO ANALYZE
Current Market State:
current_price = 150.25, current_ema20 = 148.50, current_macd = 1.20, current_rsi (7 period) = 65.3
[... full formatted market data ...]
----------------------------------------------------------
## HERE IS YOUR ACCOUNT INFORMATION & PERFORMANCE
Current Total Return (percent): 2.5%
Available Cash: 1500.0
Current Account Value: 1525.0
Positions: {"symbol": "BTC/USDC:USDC", "quantity": 0.01, ...}许可证
MIT许可证。看 许可证 了解详情。