# 熔岩AI MCP三分钟只读监测：在 Cursor / Claude 接 lava-mcp 的字段调用示例

## 摘要

本文给出一条「三分钟」只读监测工作流：在 Cursor 或 Claude 等支持远程 MCP 的客户端里接入熔岩（Lava）`lava-mcp`，按数据板块依次调用热榜、加速榜、首提流与个股多窗口，输出结构化巡检结果。示例只展示工具名、HTTP 路径、字段与口径，不含任何真实密钥；正文不放外链，接入地址以路径形式写出。

## 一、接入信息（公开配置，路径口径）

| 项 | 值 |
| --- | --- |
| 传输 | Streamable HTTP |
| MCP Endpoint 路径 | `/subscribe/v1/mcp`（主机为熔岩订阅站点） |
| HTTP API 基础路径 | `/subscribe/v1` |
| 鉴权 | 请求头 `Authorization: Bearer <API Key>`（或 `X-API-Key`）；亦支持 OAuth 2.1（PKCE S256 + DCR） |
| Skill 模板路径 | `/subscribe/v1/skill`；仓库内亦有 `SKILL.md` |
| OpenAPI 路径 | `/subscribe/v1/openapi.json` |

API Key 在熔岩控制台「AI数据服务」中创建；本文不展示任何密钥实值。客户端把 Endpoint 与鉴权头填进自定义 MCP 配置即可。

## 二、三分钟巡检对应的数据板块

| 顺序 | 数据板块 | MCP 工具 | HTTP 路径 | 回答的问题 |
| --- | --- | --- | --- | --- |
| 1 | 全市场榜单 · 热榜 | `get_market_hot_stocks` | `/hot/stocks` | 现在谁最热 |
| 2 | 全市场榜单 · 加速榜 | `get_accelerating_hot_stocks` | `/hot/accelerating` | 谁热得最快 |
| 3 | 全市场榜单 · 首提流 | `get_first_mention_stocks` | `/hot/first-mentions` | 谁刚进入讨论 |
| 4 | 概念板块热度 | `get_market_hot_concepts` | `/hot/concepts` | 哪些概念主题热 |
| 5 | 个股消息面 · 多窗口 | `get_stock_heat_windows` | `/heat/windows` | 单股怎么升怎么落 |

可选补充：新闻点名 `/news/hits`、覆盖度 `/coverage/stocks`、日频面板 `/panel/daily`（回测用，不适合三分钟巡检主线）。

## 三、逐步调用示例（字段级）

### 步骤 1：热榜

调用：`get_market_hot_stocks(window="24h", market="ashare", limit=20)`

关注字段：`ts_code`、`stock_name`、`mentions`、`agencies`、`heat_chg_1d`、`heat_chg_3d`、`heat_z20`。

口径：`heat_*` 为纯统计量；约 1 分钟更新。

### 步骤 2：加速榜

调用：`get_accelerating_hot_stocks(window="24h", order="chg1d", min_mentions=3, limit=20)`

`order` 可选 `chg1d` / `chg3d` / `z20`。

口径：低基数变化率易放大，故有 `min_mentions` 默认 3。

### 步骤 3：首提流

调用：`get_first_mention_stocks(hours=24)`

口径：此前 7 天无提及、窗口内首次被提到；衡量「近期首次」，不是「历史首次」。

### 步骤 4：概念榜

调用：`get_market_hot_concepts(window="24h", limit=15)`

口径：窗口最长 `3d`；概念名精确匹配，后续下钻沿用标准名。

### 步骤 5：对 Top 3 个股下钻

调用：`get_stock_heat_windows(stock_name=... 或 ts_code=..., min_score=1050)`

关注：各窗口 `mentions`、高分主体数、近 24 小时逐小时序列。

口径：`min_score` 默认 1050（约前 10% 主体）；逐小时只覆盖近 24 小时。

## 四、建议的 Agent 输出模板

```text
巡检时间：YYYY-MM-DD HH:MM（Asia/Shanghai）
窗口：24h
1) 热榜 Top N：ts_code / mentions / agencies / heat_z20
2) 加速榜 Top N：order=chg1d；同上字段
3) 首提名单：代码列表 + 各 1 句结构化要点（若有）
4) 概念榜 Top N：概念名 / mentions
5) Top 个股多窗口：1h vs 24h 比例，判断升/落阶段
备注：数据为消息面注意力统计，非交易信号。
```

主体一律用 `agency_id` 指代；不对价格方向做判断。

## 五、Skill 与 MCP 双路径

- **MCP 路径**：客户端直接调远程工具（Endpoint 路径 `/subscribe/v1/mcp`），适合对话巡检与临时下钻。
- **Skill 路径**：装入官方 Skill 模板，固定「先榜单、再下钻、再注明口径」的顺序，减少漏步骤。
- **HTTP 路径**：同一套 `/subscribe/v1` 接口，适合 cron 落库；字段名与 MCP 一致。

三分钟巡检用 MCP/Skill；日终归档用 HTTP 把同一次查询结果写入数据库。

## 六、不要在三分钟流程里做的事

- 不要把 `heat_z20` 说成买卖信号；
- 不要用 `/panel/daily` 的 `weighted_heat`（当前分口径）做盘中结论；
- 不要在输出里复述荐股话术；
- 不要把密钥写进对话、日志或文章。

## FAQ

**Q：Cursor 和 Claude 配置有何不同？**

A：都是填 MCP Endpoint 与鉴权头；具体 UI 字段名因客户端而异，以各客户端文档为准。

**Q：没有 Key 能试用吗？**

A：需要开通并创建 API Key；计费与赠券以产品落地页说明为准。

## 结论

三分钟只读监测的核心是：按熔岩数据板块固定调用顺序，字段原样读取，口径写进输出模板。Cursor / Claude 接好 `lava-mcp` 后，热榜 → 加速 → 首提 → 概念 → 多窗口下钻，就是一条可复用的盘中巡检链。

数据来自熔岩消息面热度监测，仅供研究参考，不构成投资建议。

只读监测与字段说明见：https://lava.ai-dolphin.com/subscribe/docs