lava-mcp

# lava-mcp

通过远程 MCP 服务器或 REST，为智能体和量化工具提供中国 A 股和概念板块受到多少消息面关注的只读数据。适合股票研究者和量化开发者。

由 dustinliang666-blip 在 GitHub 上制作。这些说明是 Mindket 根据其 README 写的，项目自己的文件和许可证在它的仓库里。

## 简介

它是什么：lava-mcp 把智能体或量化工具连接到 Lava（熔岩）。Lava 是一个服务，统计机构和有影响力的评论者提及中国 A 股股票和概念板块的频率。数据是结构化的、只读的，通过远程 MCP 服务器或 REST API 提供。新闻命中不含标题和正文。

适合谁：它适合用智能体研究 A 股市场的人，也适合需要按小时或按日衡量消息面关注度的量化交易工具开发者。

```table
行业 | 谁在用 | 怎么用 | 例子
量化交易 | 量化开发者 | 拉取日频热度序列和覆盖计数，用于回测和导出 | 读取一只股票最长 92 天内每天的提及数、机构数和加权热度
投资研究 | 使用智能体的分析师 | 让智能体找出哪些股票和概念受到更多关注 | 在 24 小时窗口内，按热度上升的速度给股票排名
市场监控 | 关注新题材的交易者 | 找出隔了一段时间才第一次被提到的股票 | 列出前 7 天没有被提到、在当前窗口里出现的股票
智能体开发 | 股票研究智能体的开发者 | 让智能体连接托管端点，而不是自己搭数据管道 | 智能体调用一个工具，拿到计数、要点和匿名的机构 ID
```

需要新闻标题或文章正文的人，或者不关注中国 A 股的人，可以跳过它。

用在哪里：任何能添加自定义远程 MCP 服务器的客户端都能使用它，直接调用 REST 也可以。

- 通过 Streamable HTTP 支持自定义远程 MCP 服务器的客户端
- WorkBuddy 国内版 5.9.3，已用浏览器 OAuth 和 get_account 工具测试过，所以不用手填密钥
- 从你自己的量化代码里调用 REST
- Lava 自己的网站，有基于同一套统计的看板

```table
使用场景 | 谁 | 得到什么
给热门股票排名 | 量化开发者 | 按提及次数和人数排序的股票，窗口从 1 小时到 7 天
发现上升的关注度 | 交易者 | 按 1 日变化、3 日变化或 z20 排名的股票
检查机构覆盖度 | 研究者 | 随时间变化的覆盖机构数量，不含 ID 列表
测试新连接 | 正在配置的人 | 账户余额和用量，不计费
```

如何设置：你需要一个 Lava 账号，以及一个支持自定义远程 MCP 服务器的客户端。

- 一个用手机号或 Google 创建的 Lava 账号
- 来自 AI 数据服务页面的 API Key，除非你的客户端用浏览器 OAuth 登录
- 一个支持自定义远程 MCP 服务器的客户端

1. 登录 Lava。在左侧菜单打开 AI 数据服务，再打开 API Key。第一次进入会送你一张代金券，并创建一个名为 default 的 Key。
2. 在你的客户端里添加一个自定义远程 MCP 服务器。使用项目 README 里列出的端点，传输方式选 Streamable HTTP。
3. 把你的 Key 放进下面所示的请求头。README 也允许用 X-API-Key 作为替代。
4. 启用连接器并查看工具列表。第一次调用请用 get_account，因为它不计费。然后再查询数据。

```text
Authorization: Bearer <API Key>
```

如何使用：用日常语言向你的智能体询问某只股票或某个概念，它会调用下面的工具。智能体还可以用 get_stock_heat_windows 查看按小时的窗口，用 get_news_stock_hits 查看新闻命中，用四个机构工具查看机构评分。

```table
工具 | 作用
get_account | 显示余额和用量，不计费
get_stock_news_heat | 显示一只股票的消息面热度和结构化要点列表
search_news_flow | 按关键词搜索结构化的消息记录
get_concept_stock_heat | 给一个概念下被提到的股票排名
get_stock_concept_heat | 给一只股票被提到的概念排名
get_market_hot_stocks | 给全市场的热门股票排名，附带 1 日变化、3 日变化和 z20
get_market_hot_concepts | 给全市场的热门概念排名，窗口最长 3d
get_weighted_hot_stocks | 给股票排名，并给高分机构更大权重，默认最低分为 1050
get_first_mention_stocks | 列出隔了 7 天没有被提到之后第一次被提到的 A 股
get_accelerating_hot_stocks | 按热度变化的快慢给股票排名
get_stock_heat_panel | 给出提及数、机构数和加权热度的日频历史，用于回测和导出
get_agency_coverage | 给出随时间变化的覆盖机构数量，只给计数
```

对于 get_accelerating_hot_stocks，窗口可以是 1h、4h、18h、24h、3d 或 7d，默认是 24h。排序可以是 chg1d、chg3d 或 z20。默认最低提及数是 3，返回条数默认 50，最多 200。

示例：你问：“过去 24 小时里，哪些 A 股的消息热度上升得最快？”智能体用默认参数调用 get_accelerating_hot_stocks。它最多返回 50 只股票，按 1 日变化排序，字段都是纯统计量。

新手与专家：Lava 统计机构和评论者提及每只股票的次数，再让你的智能体读取这些计数。它给出的是关注度数据和简短要点，不是投资建议。可以先试着连接，调用 get_account，再查询一只股票的热度。

在底层，热度由提及次数和机构覆盖度构成，有些工具还会按机构评分加权。机构只以匿名的 agency_id 出现。评分大约在 450 到 1500 之间，1000 左右居中，1050 约在前 10%。heat_chg_1d、heat_chg_3d 和 heat_z20 这类动量字段都是纯统计量。

```flow
你的客户端带着你的 Key 调用托管端点
Lava 读取它的结构化消息面热度数据
工具返回计数、要点和机构 ID
新闻命中不含标题和正文
```

注意事项：

- 所有数据都是只读的，新闻命中只给出新闻 ID、媒体和命中的股票
- 注册会送 100 元代金券，大约 1000 次调用收费 5 元
- get_stock_heat_panel 一次调用最多覆盖 92 天和 20 个标的
- 板块趋势已在 Lava 网站上线，但它的订阅 API 仍在规划中
- 情绪面数据在规划中，只会提供聚合统计
- 本仓库没有用于转发调用的本地代理，所以只使用托管端点
- 已经运行过这类代理的人，应当到 Lava 数据控制台更换 API Key

## GitHub 上的数据（2026年11月7日）

- 星标：65
- 复刻：0
- 未关闭的议题和拉取请求：1
- 许可证：MIT
- 话题：a-share, agent-skills, claude-skills, dsh-plugin, gemini-cli-extension, mcp, mcp-server, quant

## 链接

- 代码：https://github.com/dustinliang666-blip/lava-mcp
- 网站：https://lava.ai-dolphin.com/
- 发布版本：https://github.com/dustinliang666-blip/lava-mcp/releases
- 议题：https://github.com/dustinliang666-blip/lava-mcp/issues
- 星标历史：https://www.star-history.com/#dustinliang666-blip/lava-mcp&Date

## 获取代码

```
git clone https://github.com/dustinliang666-blip/lava-mcp.git
```

然后按它的 README 完成设置。这个工具包里没有会自己运行的东西。

README.md  7 KB