laogu-mcp is a zero-key, zero-login MCP data server that exposes 16 A-share finance data tools (quotes, filings, dragon-tiger list, margin data, unlocks, valuation, macro helpers) for any MCP-compatible client, returning a unified JSON envelope and never fabricating numbers.
Stock quotes: quote returns per-stock snapshot (price, change, open/prev close, high/low, volume, turnover) with data timestamp.
Market overview: market_snapshot and close_recap return A-share indices, US indices, WTI crude, COMEX gold, and offshore RMB.
Announcements: ann_list lists recent filings with art_code; ann_content fetches full text (auto-paginated) plus PDF links.
Targeted filing scans: earnings_ann (performance forecasts), ir_records (investor relations records), unlock_notices (share unlock notices), risk_inputs (quote + latest periodic report locator).
Fund flows: fund_flow provides per-stock margin financing data or market-wide dragon-tiger money top lists; lhb_board gives detailed dragon-tiger list with auto date rollback.
Verification & grounding: code_verify checks ticker ↔ official name; research_grounding supplies code check + quote for research report interpretation.
Valuation: valuation returns PE(TTM)/PB/market cap/price where available, flagging unverified gaps.
Macro helper: macro_helper checks trading-day status, Beijing time, and US market session notes.
Honest failure mode: tools without stable public APIs (Chinese-name→code lookup, IPO calendar, macro events) return ok:false with search templates instead of guessing.
Deployment: one-line install via uvx laogu-mcp; works with Claude Desktop, Cherry Studio, and any stdio MCP client.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@laogu-mcp 查一下贵州茅台现在的行情，再看看最近的公告"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
16 个「老谷拆财报」财经 skill 的程序化数据层：A 股行情、公告、龙虎榜、两融、解禁、估值……一次装好，16 个场景 tool 随便调。
零 key、零登录、零配置：全部走公开接口，不用申请任何 token。 以数据为刃，剖市场真相 —— 个人观点，仅供参考，不构成投资建议。
一键安装：装好 Python 3.10+ 与 uv 后，一行启动
uvx laogu-mcp每个 tool 对应一个 laogu-* skill 的数据抓取部分；解读逻辑由宿主 LLM 按各 skill 的 Output Contract 执行（见 tool 描述）。契约动态同步：tool 描述在静态快照基础上，自动拼接 GitHub 最新版 skill 的 Output Contract（启动时同步）。
tool | 对应 skill | 一句话 |
| laogu-fundamentals | 个股行情快照（现价/涨跌/成交量额） |
| laogu-announcements | 个股公告列表（含取正文的 art_code） |
| laogu-news | 股票代码↔官方简称核对 |
| laogu-morning | A股指数+美股+原油+黄金+离岸人民币 |
| laogu-moneyflow | 个股两融 / 全市场龙虎榜资金 Top |
| laogu-close | 收盘指数快照 |
| laogu-lhb | 龙虎榜明细（自动回滚到最近交易日） |
| laogu-report | 公告正文全文抓取（自动翻页） |
| laogu-risk | 财务风险体检输入（行情+定期报告定位） |
| laogu-earnings | 业绩预告/快报公告扫描 |
| laogu-research | 研报解读 grounding（代码核对+行情） |
| laogu-notes | 投资者关系活动记录表搜索 |
| laogu-unlock | 限售解禁公告搜索 |
| laogu-ipo | 打新日历（无公开接口时诚实返回搜索模板） |
| laogu-value | 估值锚输入（PE/PB/市值） |
| laogu-macro | 交易日校验+北京时间换算+宏观搜索模板 |
冒烟测试 18 次调用全部按设计通过（2026-09-29 实测，见 smoke/mcp-smoke.md）：16 项取到真实数据；2 项因无稳定公开接口而诚实返回 ok:false + 搜索模板，绝不编数——中文简称→代码（无稳定简称→代码接口，不猜测）、打新日历（无稳定公开程序化接口，不编造日历）。2026-11-09 沙盒重跑 18 次调用，结果一致（16 通过 + 2 诚实失败）。
返回格式是统一 JSON 信封：成功失败都一样的结构，失败时 ok: false 带 reason 和 search_templates（网页搜索关键词）；取不到的字段标 null 并在 warnings 说明，不估算。
Related MCP server: cn-financial-mcp
装 Python 3.10 或更新（python.org 下载，一路"下一步"）。
装 uv（命令行工具，复制粘贴下面一行）：
Windows（PowerShell）：powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
Mac/Linux：curl -LsSf https://astral.sh/uv/install.sh | sh
测试一行能跑：uvx laogu-mcp（看到启动日志即成功，按 Ctrl+C 退出）。
打开 Claude Desktop → 设置 → 开发者 → MCP 服务器 → 编辑配置文件，加入：
{
"mcpServers": {
"laogu-mcp": {
"command": "uvx",
"args": ["laogu-mcp"]
}
}
}保存后重启 Claude Desktop，对话框输入框下方出现 🔌 图标即装好。
设置 → MCP 服务器 → 添加服务器 → 类型选"标准输入输出 (stdio)"：
名称：laogu-mcp
命令：uvx
参数：laogu-mcp
保存后开关打开，状态显示"已连接"即成功。
统一 JSON 信封，成功失败都一样的结构：
{
"ok": true,
"data": { "...": "..." },
"meta": {"source": "新浪行情", "fetched_at": "2026-09-29 03:55:00", "timezone": "北京时间"},
"warnings": ["腾讯行情不可用，已降级到新浪行情"]
}失败时 ok: false，带 reason 和 search_templates（网页搜索关键词），绝不编数字。
取不到的字段标 null 并在 warnings 说明，不估算。
关键数据带日期时点和来源；单源数据标注来源。
北向"净流入/净买入"口径已死（2024-08-19 起），本 server 不输出该数字。
只做数据抓取，解读由宿主 LLM 按各 skill 的 Output Contract 执行；不做买卖推荐。
公共接口不提供具体龙虎榜营业部，绝不编造。
接口 | 状态 |
新浪行情（含指数/美股/期货/外汇） | ✅ |
东财公告列表 / 正文 | ✅ |
东财龙虎榜 / 两融 | ✅ |
腾讯行情 | ⚠️ 部分网络超时（自动降级） |
东财 push2 | ⚠️ 部分网络 502（自动降级） |
git clone https://github.com/laogu-caibao/laogu-mcp
cd laogu-mcp
uv venv && uv pip install -e .
python smoke/run.py # 冒烟测试（真实数据）laogu-mcp/
├── src/laogu_mcp/ # server.py（16 个 tool）+ _sources.py（公开接口层）+ _contracts.py（契约同步）+ _config.py
├── smoke/ # 冒烟测试：run.py（真实数据）+ results.json + mcp-smoke.md（2026-09-29 实测报告）
├── tests/ # test_config.py
├── packaging/ # .mcpb 打包
├── server.json # MCP server 清单（v1.1.1）
├── smithery.yaml # Smithery 发布配置
├── pyproject.toml # 打包配置（v1.1.1）
├── DESIGN.md # 设计文档
├── MARKET.md # 市场调研
├── config-schema.md # 配置说明
├── LICENSE # MIT
└── README.md # 本文件本仓库自带冒烟测试（真实数据）：
python smoke/run.py # 18 次调用：16 项取真实数据 + 2 项诚实失败（见上）发现 bug 或有改进建议，以 [QC] <一句话问题> 为标题提交到 https://github.com/laogu-caibao/laogu-mcp/issues，正文写清“复现步骤 → 实际表现 → 期望表现”。
laogu-mcp — MCP data server. The programmatic data layer behind the skills: 16 finance tools (quotes, filings, dragon-tiger list, margin data, unlocks, valuation). Zero API keys, zero login, zero config — public endpoints only. Install: uvx laogu-mcp.
Q：laogu-mcp 有什么用？ 适合的场景：不想逐个装 skill，只想在任意支持 MCP 的客户端里直接调 16 个 A 股财经数据工具（零 key）。
Q：数据可靠吗？会荐股吗？ 数字必须来自可核验的公开来源（上市公司公告、交易所公开数据、公开网页），取不到就标「未核验」，绝不编造；只做数据抓取与结构化整理，不构成投资建议。
Q：怎么安装？支持哪些客户端？
uvx laogu-mcp支持 Claude Desktop、Cherry Studio 与任意支持 MCP（stdio）的客户端，配置见上文。更多 skill 见老谷拆财报组织主页。
—— 老谷拆财报 · laogu-mcp · 出品：老谷拆财报（抖音/视频号/头条/快手同名） 个人观点，仅供参考，不构成投资建议
公告正文抓取（对应 skill：laogu-report 定期报告深拆）。
输入 art_code（从 ann_list/ann 相关 tool 获取）。自动翻页抓取全文，去 HTML 标签， 返回纯文本正文 + 附件(PDF)链接。 输出契约：正文原样返回不改写；定期报告财务数字以正文为准，解读时双源交叉。 数据源：东财公告正文接口（2026-09-29 实测可用）。
Inputs: art_code (required). Returns: object
个股公告列表（对应 skill：laogu-announcements 公告盯梢）。
输入 6 位股票代码。输出最近公告：art_code（取正文用）/标题/发布时间/公告日期/栏目。 输出契约：按发布时间倒序；只返回接口真实条目，不脑补"应有公告"。 数据源：东财公告接口（2026-09-29 实测可用）。只陈述事实，不做买卖推荐。
Inputs: code (required), page_size. Returns: object
收盘指数快照（对应 skill：laogu-close 盘后复盘）。
返回 A股四大指数今日涨跌幅/现价/成交量/成交额。输出契约：数字标注日期； 涨跌家数、板块涨跌幅无稳定公开接口，缺口在 warnings 标注"未核验"，不编造。 只陈述事实，不做买卖推荐。数据源：新浪行情。
Inputs: no named parameters. Returns: object
新闻提及公司 → 股票代码核对（对应 skill：laogu-news 财经资讯解读）。
输入 6 位股票代码：返回官方简称核对结果（用行情接口反查名称）。 输入中文简称：目前无稳定公开的"简称→代码"程序化接口，诚实返回 ok=false + 网页搜索模板，不猜测代码（猜错代码=张冠李戴，比没有更糟）。 输出契约：核对成功返回{代码, 官方简称}；失败必须走搜索模板人工确认。
Inputs: keyword (required). Returns: object
业绩预告/快报扫描（对应 skill：laogu-earnings 业绩预告解读）。
从公告列表筛选标题含"业绩预告"/"业绩快报"/"业绩预告修正"的公告，返回 art_code/ 标题/公告日期（正文用 ann_content 另取，提炼利润区间与同比口径）。 输出契约：只返回接口真实条目；利润区间数字以正文为准，本 tool 不提前解读； 无预告时明确返回空列表，不编造。只陈述事实，不做买卖推荐。
Inputs: code (required), page_size. Returns: object
资金流向（对应 skill：laogu-moneyflow 资金流向解读）。
kind="margin"：个股两融（需传 code），返回最近5个交易日融资余额/融资买入额/ 融资偿还额/融资净买入（=买入-偿还）/融券余额，数据 T+1，日期以接口实际返回为准。 kind="lhb"：全市场龙虎榜资金（code 可空），返回最近有数据交易日的净买入/净卖出 Top5（代码/名称/涨跌幅/净买额/席位标签）。 输出契约：数字原样引用并标注单位与数据日期；北向资金自2024-08-19起无日度净买入 口径，本工具不输出任何"北向净流入"数字。只陈述事实，不做买卖推荐。 数据源：东财 datacenter（2026-09-29 实测可用）。
Inputs: code, kind. Returns: object
打新日历（对应 skill：laogu-ipo）。
诚实声明：新股申购/上市日期无稳定公开程序化接口（2026-09-29 实测结论）， 本 tool 返回 ok=false + 本周打新搜索模板，不编造任何新股代码/日期/发行价。 宿主应按 laogu-ipo 的 Output Contract 用搜索结果生成日历，无新股时明确说明。
Inputs: no named parameters. Returns: object
投资者关系活动记录表搜索（对应 skill：laogu-notes 调研纪要解读）。
从公告列表筛选标题含"投资者关系活动记录表"的公告，返回 art_code/标题/公告日期 （纪要正文用 ann_content 另取后结构化提炼）。 输出契约：只返回真实条目；无记录表时返回空列表并标注，不编造调研内容。 只陈述事实，不做买卖推荐。数据源：东财公告接口。
Inputs: code (required), page_size. Returns: object
龙虎榜明细（对应 skill：laogu-lhb 龙虎榜夜报）。
trade_date 为空时自动回滚到最近有数据的交易日（最多回滚10天，跳过周末）。 输出：上榜总数 + 净买入/净卖出 TopN（代码/名称/涨跌幅/净买额/买入额/卖出额/ 上榜原因/席位标签）。 输出契约：分类只看席位类型（机构/游资地域资金/股通），不看标签里"买入/卖出"字样； 公共接口不提供具体营业部，绝不编造；席位标签原样引用。只陈述事实，不做买卖推荐。 数据源：东财 datacenter RPT_DAILYBILLBOARD_DETAILSNEW（2026-09-29 实测可用）。
Inputs: top_n, trade_date. Returns: object
宏观日历辅助（对应 skill：laogu-macro 宏观日历解读）。
返回：指定日期（默认今天）是否为 A 股交易日（周末直接判否；工作日用龙虎榜 数据存在性交叉验证，标注为启发式）、北京时间、美股时段说明。 诚实声明：议息会议/PMI/CPI 等事件无统一公开 API，本 tool 不编造事件日历， 返回搜索模板由宿主按 laogu-macro 的 Output Contract 生成。 只陈述事实，不做买卖推荐。
Inputs: date. Returns: object
市场快照（对应 skill：laogu-morning 每日市场早报 / laogu-close 盘后复盘）。
一次返回：A股四大指数（上证/深证成指/创业板/北证50）、美股三大指数（道指/纳指/标普）、 WTI原油、COMEX黄金、离岸人民币。 输出契约：每项带名称/现价/涨跌幅/时间；美股标注"盘中价/已收盘"（北京时间凌晨4点前 为盘中价）；A股成交额字段不可靠时标 null 不硬写全市场成交额。只陈述事实，不做买卖推荐。 数据源：新浪行情（2026-09-29 实测可用）。
Inputs: no named parameters. Returns: object
个股行情快照（对应 skill：laogu-fundamentals 基本面速查）。
输入 6 位股票代码（如 600519）。输出：名称/现价/涨跌幅/今开/昨收/最高/最低/ 成交量/成交额，含数据日期时点。 输出契约：数字原样引用接口值并标注单位；取不到的字段标 null 并在 warnings 说明， 不估算、不编造。只陈述事实，不做买卖推荐。 数据源：腾讯行情 → 新浪行情 → 东财 push2（三级降级，见 warnings）。
Inputs: code (required). Returns: object
研报精读 grounding 数据（对应 skill：laogu-research 研报精读）。
返回代码核对（官方简称）+ 行情快照，供研报解读时交叉验证。 诚实声明：研报正文无稳定公开程序化接口，本 tool 不提供研报内容； 研报全文/链接需用户粘贴，宿主按 laogu-research 的 Output Contract 解读。 只陈述事实，不做买卖推荐。
Inputs: code (required). Returns: object
财务风险体检输入（对应 skill：laogu-risk 财务风险预警）。
返回：行情快照 + 最新一期定期报告定位（从公告列表找标题含"年度报告"/"半年度报告"/ "季度报告"的最新一条：art_code/标题/公告日期）。 输出契约：本 tool 只做输入准备，不打分；定期报告正文需再调 ann_content 获取； 报告期以公告标题为准，不推测。只陈述事实，不做买卖推荐。
Inputs: code (required). Returns: object
限售解禁公告搜索（对应 skill：laogu-unlock 解禁冲击评估）。
从公告列表筛选标题含"限售股份上市流通"/"限售股上市流通"/"解除限售"的公告， 返回 art_code/标题/公告日期（解禁规模/占比/股东性质以正文为准，用 ann_content 另取）。 输出契约：抛压定级需正文数据，本 tool 只做公告定位；无相关公告时返回空列表。 只陈述事实，不做买卖推荐。数据源：东财公告接口。
Inputs: code (required), page_size. Returns: object
估值锚输入（对应 skill：laogu-value 估值定位）。
返回当前 PE(TTM)/PB/市值/现价（能取到的才给）。输出契约：历史分位区间与同行 对比无稳定公开接口，缺口在 warnings 标注"未核验"，由宿主用搜索补足； 只描述分位位置，不做买卖推荐。 数据源：腾讯行情（含PE/PB）→ 新浪 → 东财push2。
Inputs: code (required). Returns: object
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 16 tools
Several tools overlap: ann_list/earnings_ann/ir_records/unlock_notices are all announcement-list title filters, fund_flow (kind=lhb) and lhb_board both surface 龙虎榜 data, and quote/market_snapshot/close_recap all return index/quote snapshots. Descriptions do clarify boundaries, but an agent could still misselect among the announcement and lhb tools.
All names use a consistent snake_case convention with no camelCase or style mixing. The verb_noun pattern is not strictly uniform (quote, valuation, ann_content are noun phrases; code_verify is verb_noun), but the overall style is predictable and readable.
16 tools is slightly above the ideal band but each maps to a distinct skill/workflow (fundamentals, announcements, moneyflow, lhb, earnings, IR, unlock, IPO, valuation, macro). The count is defensible and no tool feels purely redundant.
The surface covers a broad A-share lifecycle: quotes, valuation, announcements, fund flow, lhb, earnings, IR, unlock, IPO, and macro. Gaps exist (no actual news-fetch tool, research content unavailable, several tools return ok=false with search templates), but these are honestly documented rather than silently missing.
China A-share market data over MCP: 22 tools for quotes, K-line, financials, money flow, top-trader boards, sectors, macro, convertible bonds and factor screening. Five tools need no API key, so you can connect and try it immediately.
Provide access to Chinese stock market data including historical prices, real-time data, news, and…
China A-share data for AI agents: 57 read-only tools plus 6 tools for your own watchlist.
Access real-time and historical market data for China A-shares and Hong Kong stocks, along with ne…
