> For the complete documentation index, see [llms.txt](https://docs.hyperbot.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hyperbot.network/cn-zhong-wen-ban-ben/guan-fang-lian-jie/hyperbot-ai-agent-mcp-skills/kuai-su-jie-ru.md).

# 快速接入

#### OpenClaw Bot 用户

\
将以下 Skill URL 提供给你的 OpenClaw Bot，Bot 会自动完成两件事：<br>

1. 读取 Skill 页面，获取 Hyperbot MCP 的工具说明
2. 根据说明自动安装并连接 Hyperbot MCP 服务器

完成后即可直接提问，全程无需手动操作。<br>

```
https://clawhub.ai/developHyperbotNetwork/hyperbot-quote-mcp
```

\
也可以手动添加 MCP Server：打开 Settings → MCP → Add Server，填入：

* **Name**：hyperbot-trading
* **URL**：`https://mcp.hyperbot.network/mcp/sse`

配置完成后重启 OpenClaw 生效。

***

\
**前置条件：** 需要安装 Node.js 18+<br>

* macOS：`brew install node`
* Windows：前往 <https://nodejs.org/> 下载安装<br>

**配置文件路径：**

* macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`
* Windows：`%APPDATA%\Claude\claude_desktop_config.json`
* Linux (AppImage)：`~/.config/Claude/claude_desktop_config.json`<br>

**配置内容：**<br>

```json
{
  "mcpServers": {
    "hyperbot-trading": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.hyperbot.network/mcp/sse"]
    }
  }
}
```

\
**安装步骤：**<br>

1. 打开 Claude Desktop → Settings → Developer → Edit Config
2. 将上方配置内容填入文件并保存
3. 重启 Claude Desktop（Cmd/Ctrl + R）
4. 在 MCP 工具列表中确认 Hyperbot 工具已出现
   1\.

***

#### Cursor 用户

\
**方式一：通过 UI 添加（推荐）**\
打开 Cursor Settings → Tools & Integrations → MCP → Add New MCP Server，填入：

* **Name**：hyperbot-trading
* **Type**：sse
* **URL**：`https://mcp.hyperbot.network/mcp/sse`

**方式二：直接编辑配置文件**\
编辑 `~/.cursor/mcp.json`：<br>

```json
{
  "mcpServers": {
    "hyperbot-trading": {
      "type": "sse",
      "url": "https://mcp.hyperbot.network/mcp/sse"
    }
  }
}
```

\
配置完成后重启 Cursor 生效。\
**Linux 用户路径：** `~/.cursor/mcp.json`（同上）\
**安装验证：** 重启后在 MCP 工具列表中确认以下工具已出现：`fetch_leader_board`、`get_whale_positions`、`get_trader_stats` 等。\
**常见问题排查：**<br>

| 问题             | 解决方法                           |
| -------------- | ------------------------------ |
| 工具未出现          | 重启 Cursor                      |
| 连接超时           | 检查网络或防火墙设置                     |
| mcp-remote 未找到 | 运行 `npm install -g mcp-remote` |

***

#### 其他 AI Agent / 自定义接入

\
如果你在开发自己的 AI Agent 或应用，可以直接将 Hyperbot MCP 集成进来：

| 参数     | 值                                          |
| ------ | ------------------------------------------ |
| SSE 端点 | `https://mcp.hyperbot.network/mcp/sse`     |
| 消息端点   | `https://mcp.hyperbot.network/mcp/message` |
| 协议     | JSON-RPC 2.0                               |

\
支持直接 SSE URL 的客户端：

```json
{
  "type": "sse",
  "url": "https://mcp.hyperbot.network/mcp/sse"
}
```

\
需要 mcp-remote 的客户端（如 Claude Desktop）：

```json
{
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://mcp.hyperbot.network/mcp/sse"]
}
```

<br>

> **获取 sessionId：** 先 GET 请求 SSE 端点，从响应中取得 sessionId，后续消息请求携带 `?sessionId={your-session-id}` 参数即可。

***

### 能力全览

\
以下 22 个数据工具由 **Hyperbot MCP** 提供；**Skills** 负责告诉 AI Agent 何时调用哪个工具。两者共同覆盖 Hyperliquid 链上博弈分析的 6 大维度。<br>

#### 聪明钱榜单与发现

| 工具                   | 能做什么                                            |
| -------------------- | ----------------------------------------------- |
| `fetch_leader_board` | 获取聪明钱排行榜，支持按盈利额或胜率排序，周期 24h / 7d / 30d          |
| `find_smart_money`   | 多维度筛选聪明钱地址，9 种排序方式（胜率、ROI、账户余额、持仓数等），可附带 PnL 曲线 |

#### 市场行情

| 工具                  | 能做什么                                                         |
| ------------------- | ------------------------------------------------------------ |
| `get_tickers`       | 获取所有币种最新价格                                                   |
| `get_ticker`        | 获取指定币种最新价格                                                   |
| `get_klines`        | K 线数据，含主动买卖量，支持 1m / 3m / 5m / 15m / 30m / 1h / 4h / 8h / 1d |
| `get_market_stats`  | 当前挂单多空统计、鲸鱼挂单占比、市场中间价                                        |
| `get_l2_order_book` | L2 订单簿完整深度                                                   |

#### 鲸鱼监控

| 工具                        | 能做什么                         |
| ------------------------- | ---------------------------- |
| `get_whale_positions`     | 当前鲸鱼持仓，支持按方向、盈亏、资金费率多维度过滤与排序 |
| `get_whale_events`        | 实时鲸鱼开仓 / 平仓事件流               |
| `get_whale_directions`    | 当前鲸鱼多空持仓数量统计，可按币种筛选          |
| `get_whale_history_ratio` | 历史多空比走势（1h / 1d 粒度）          |

#### 交易员分析

| 工具                        | 能做什么                             |
| ------------------------- | -------------------------------- |
| `fetch_trade_history`     | 指定钱包地址的完整历史交易明细                  |
| `get_trader_stats`        | 综合统计：胜率、盈亏、持仓时长、交易次数             |
| `get_max_drawdown`        | 最大回撤，支持 1 / 7 / 30 / 60 / 90 天区间 |
| `get_best_trades`         | 周期内收益最高的若干笔交易                    |
| `get_performance_by_coin` | 按币种拆分的胜率与盈亏表现                    |

#### 持仓历史

| 工具                                  | 能做什么                     |
| ----------------------------------- | ------------------------ |
| `get_completed_position_history`    | 已完成仓位的完整历史变动             |
| `get_current_position_history`      | 当前持仓的历史状态变化（无持仓时返回 400）  |
| `get_completed_position_executions` | 已平仓位的买卖执行轨迹（可按时间区间和粒度查询） |
| `get_current_position_pnl`          | 当前持仓的盈亏曲线                |

#### 批量查询

***

### 数据更新频率

| 数据类型        | 更新频率             |
| ----------- | ---------------- |
| 市场行情 / 鲸鱼仓位 | 实时               |
| 交易员统计       | 每 5 分钟           |
| 聪明钱榜单       | 每小时              |
| 接口频率上限      | 100 次 / 分钟（单 IP） |

***

<br>

### 常见问题

\
**Hyperbot MCP 和 Hyperbot Data API 有什么区别？**\
两者底层数据相同，定位不同。MCP + Skills 面向 AI Agent 场景，无需编程，用自然语言驱动；Data API 面向开发者，提供更完整的接口覆盖（包括 WebSocket 实时推送、强平数据、TWAP 等），适合量化系统和产品集成。

\
**Claude Desktop 用户必须安装 Node.js 吗？**\
是的，Claude Desktop 通过 `mcp-remote` 桥接连接远程 MCP 服务器，而 `mcp-remote` 依赖 Node.js 18+ 运行。macOS 用户可用 `brew install node` 安装，Windows 用户前往 nodejs.org 下载。

\
**Cursor 还需要单独安装 Skills 吗？**\
MCP 连接配置（`mcp.json`）是让 Cursor 能调用 Hyperbot 工具的必要步骤。Skills（`npx skills add`）是可选的补充——它给 AI 提供更详细的工具使用说明，有助于 AI 更准确地选择和调用工具。

\
**什么是 MCP（Model Context Protocol）？**\
MCP 是 Anthropic 推出的开放协议，允许 AI 助手通过标准接口调用外部数据和工具服务。Hyperbot MCP 基于该协议，将链上博弈数据封装为 AI 可直接调用的工具集。

\
**数据覆盖哪些链？**\
当前 Hyperbot MCP 专注于 Hyperliquid 生态的链上数据，包括聪明钱、鲸鱼持仓、市场行情与交易员分析。

\
**接口有使用限制吗？**\
单 IP 每分钟最多调用 100 次；批量查询接口每次最多支持 50 个地址。