stock-mcp

中国 A 股行情 MCP

为 AI Agent 提供中国 A 股及市场指数实时行情。可按股票代码（sh600519、600519）或中文名称（贵州茅台）查询，并支持自动名称解析和双数据源。

• 30 秒即可试用：免费的公共 MCP 端点已在运行，只需将 URL 粘贴到 MCP 客户端中（无需安装，也无需 API 密钥）。
• 也可自托管：小型 FastMCP 服务，仅使用免费的公共行情端点（腾讯财经为主，新浪财经为备用）。无需付费 API，也无需密钥。

⚡ 使用托管端点（无需设置）

https://mcp.pianam.cn/stock-mcp/mcp

传输方式：Streamable HTTP（兼容 MCP 2025-03-26）。无需身份验证。

🔌 客户端配置

将以下内容添加到 MCP 客户端的 mcpServers 配置中（Claude Desktop、Cursor、Cline、Cherry Studio 等）：

{
  "mcpServers": {
    "stock": {
      "type": "http",
      "url": "https://mcp.pianam.cn/stock-mcp/mcp"
    }
  }
}

不接受 "type": "http" 的客户端，可使用仅包含 "url" 的相同条目。

🧰 工具

| 工具 | 参数 | 返回内容 | |

---|---|---| | query_stock_quote(stock) | stock：股票代码（sh600519、SH600519、600519、000858）或中文名称（贵州茅台、宁德时代）。 | 名称、代码、当前价格、前收盘价、开盘价、最高价/最低价、涨跌额及涨跌幅、方向（涨/跌/平）、成交量（股及手）、成交额、更新时间、数据来源。 | | query_index() | （无） | A 股三大指数——上证指数 / 深证成指 / 创业板指：点位、涨跌、开盘价/前收盘价/最高价/最低价，以及整体市场趋势摘要（全面上涨 / 多数下跌等）。 |

示例

• “贵州茅台现在多少钱？” → 贵州茅台实时行情。
• “查一下 300750” → 宁德时代实时行情。
• “今天大盘怎么样？” → 三大指数及市场趋势。

📡 数据来源

• 主要来源：腾讯财经实时行情端点（qt.gtimg.cn）——免费的公共接口，采用 GBK 编码，无需密钥。
• 备用来源：新浪财经（hq.sinajs.cn，请求时附带 Referer 标头）——主要来源失败时自动使用。
• 名称 → 代码解析使用腾讯搜索建议 API，并内置约 50 只常见股票的映射，可即时查询。
• 所有请求均设有超时，并支持优雅降级；无需 API 密钥或注册。

数据仅供参考；根据数据提供商的信息，数据可能存在延迟或仅供参考，不构成投资建议。

🐢 自托管

git clone https://github.com/boy-373/stock-mcp.git
cd stock-mcp
pip install -r requirements.txt
python server.py
# listens on 127.0.0.1:8000 by default; override with:
#   MCP_HOST=0.0.0.0 MCP_PORT=9000 python server.py
# behind a reverse proxy, allow your public hostname:
#   MCP_ALLOWED_HOSTS="your-domain.com,your-domain.com:*" python server.py

然后将 MCP 客户端指向 http://127.0.0.1:8000/mcp。

使用 uv：

uv venv && uv pip install -r requirements.txt
uv run python server.py

🗂️ 文件

• stock_server.py — MCP 服务：代码/名称解析、腾讯和新浪行情解析、FastMCP 工具定义。
• server.py — 独立的 Streamable HTTP 入口（在 /mcp 提供 MCP 应用）。
• requirements.txt — Python 依赖项。
• LICENSE — MIT。

---

🇨🇳 中文说明

A 股实时行情 MCP：个股行情查询（支持代码 sh600519/600519 或中文名「贵州茅台」，内置约 50 只常用股映射 + 腾讯搜索补全）与三大指数查询（上证 / 深成 / 创业板，含市场整体涨跌趋势）。

在线直连（免费、无需密钥）：https://mcp.pianam.cn/stock-mcp/mcp

主要数据源为腾讯财经（qt.gtimg.cn，免费公共接口），失败时自动降级为新浪财经（hq.sinajs.cn）；所有请求均设有超时，并提供友好错误提示，无需任何 API 密钥。数据仅供参考，不构成投资建议。

📄 许可证

MIT © 2026 boy-373 (刘扶阳)