dustinliang666-blip/lava-mcp

熔岩（Lava） 提供 A 股股票和概念板块的消息面热度监测 结构化只读数据——支持 量化交易工具 与 AI Agent 股市研究 接入，通过远程 MCP / REST 调用。
> 只读 · 结构化要点 + 机构/大V ID（agencyid）· 新闻命中不含标题与正文
## 新手 3 步
① 开通并复制 API Key（登录熔岩 → 左侧「AI数据服务」→ API Key → 新建；首次登录通常已自动生成「默认」Key）
② 装 Skill，或在豆包办公 / WorkBuddy / 千问办公填 MCP 地址 https://lava.ai-dolphin.com/subscribe/v1/mcp
③ 用中文问「某某股票最近消息面热不热」，或「最近 24 小时全市场哪些股票消息面最热」
## 远程 MCP（推荐）
| 项 | 值 |
| 传输 | Streamable HTTP |
| Endpoint | https://lava.ai-dolphin.com/subscribe/v1/mcp |
| 鉴权 | 请求头 Authorization: Bearer （或 X-API-Key）；亦支持 OAuth 2.1（PKCE S256 + DCR） |
| 客户端 | 豆包办公、WorkBuddy（BUDDY）、千问办公（QwenWork）等支持自定义 HTTP MCP 的客户端 |
开通与计费见 落地页：开通赠 100 元代金券；约 1000 次 = 5 元。
## 本地 Streamable HTTP 代理
proxy/server.py 是可运行的薄代理（Python 3.9+，仅标准库）。它不实现熔岩的查询接口，只把 MCP 的 Streamable HTTP / JSON-RPC 原样转到官方端点，并附上 Authorization: Bearer 。个股、概念和热榜数据仍来自 https://lava.ai-dolphin.com。
直接连接官方端点仍然是推荐方式。本地代理适合需要在本机审计转发代码，或客户端不方便单独配置远程请求头的时候。
bash
export LAVAAPIKEY=lvk你的Key
python3 proxy/server.py
默认监听 http://127.0.0.1:8787/mcp（只绑定本机）。
| 环境变量 | 说明 |
| LAVAAPIKEY | 熔岩 API Key。设置后，每个转发请求都带 Authorization: Bearer |
| LAVAPROXYPORT | 监听端口，默认 8787 |
| LAVAPROXYHOST | 监听地址，默认 127.0.0.1。监听非本机地址时还要设置 LAVAPROXYALLOWREMOTE=1 |
| LAVAMCPUPSTREAM | 上游地址，默认 https://lava.ai-dolphin.com/subscribe/v1/mcp |
| LAVAPROXYTIMEOUT | 上游超时（秒），默认 180；0 表示不限制 |
客户端把 MCP 地址填成 http://127.0.0.1:8787/mcp，传输选 Streamable HTTP。Key 放在启动代理的环境里即可。未设置 LAVAAPIKEY 时，才会原样转发客户端自己的 Authorization 头。
bash
curl -sS http://127.0.0.1:8787/health
curl -sS http://127.0.0.1:8787/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'
GET /health 只检查代理进程，不访问上游。本地测试：python3 -m unittest proxy.testserver。
## Skill 模板
仓库内 SKILL.md 与线上官方模板对齐（含全市场热榜、加权、首提、多时间窗、加速榜、日频面板、机构覆盖度与新闻点名）。官方模板：
https://lava.ai-dolphin.com/subscribe/v1/skill
## 文档与机器可读规范
产品落地页：https://lava.ai-dolphin.com/subscribe
API 文档（canonical）：https://lava.ai-dolphin.com/subscribe/docs
OpenAPI 3.0：https://lava.ai-dolphin.com/subscribe/v1/openapi.json
llms.txt：https://lava.ai-dolphin.com/llms.txt
MCP Registry：server.json
本地代理：proxy/server.py
Glama：glama.json · 线上 /.well-known/glama.json
## 数据模块一览
熔岩同时有站内看板和订阅 API / MCP。数据是 A 股机构/大V 舆情的结构化只读：概念和标的给摘要要点，机构/大V 用匿名 agencyid。订阅落地页是 https://lava.ai-dolphin.com/subscribe ；文档、OpenAPI、MCP 与 Skill 都在同一域名下。
表中的工具名与本文以及线上 OpenAPI 一致。板块趋势和情绪面的订阅路径尚未开放。
| 模块 | 站内 | 订阅 API / MCP | 说明 |
| 个股消息面热度 | 个股页 / 市场热度 | getstocknewsheat、getstockheatwindows、searchnewsflow | 提及次数、机构/大V 覆盖、摘要要点 |
| 概念板块消息面热度 | 概念页 / 概念热榜 | getmarkethotconcepts、getconceptstockheat、getstockconceptheat | 概念提及排行，以及概念与个股互查 |
| 全市场热榜 / 加速 / 首提 / 高分加权 | 市场热度 | getmarkethotstocks、getacceleratinghotstocks、getfirstmentionstocks、getweightedhotstocks | 多时间窗；动量字段为纯统计量 |
| 日频热度面板 / 机构覆盖度 | 个股页 | getstockheatpanel、getagencycoverage | 日频序列与覆盖计数，适合回测与导出 |
| 新闻点名 | — | getnewsstockhits | 只返回 newsid、媒体、命中股票；无标题、无正文 |
| 机构/大V 评分（PIT） | 市场热度 | getagencyranking、getagencypit、getagencyhistory、listagencypitdates | 用 agencyid；分数大约 450~1500 |
| 板块趋势 | 站内已上线：侧栏「市场热度」→「板块热度」 | 站内可用 · 订阅接口规划中 | 消息热度 Δ、资金流入流出、价格指数与成分股；口径对齐东财/同花顺 |