stock-mcp

China A-Share Stock Quotes MCP

Real-time China A-share stock & market-index quotes for AI agents. Query by stock code (sh600519, 600519) or by Chinese name (贵州茅台), with automatic name resolution and dual data sources.

• Try it in 30 seconds: a free public MCP endpoint is already running — just paste the URL into your MCP client (no install, no API key).
• Or self-host: a small FastMCP server using only free public quote endpoints (Tencent Finance primary, Sina Finance fallback). No paid API, no key.

⚡ Use the hosted endpoint (no setup)

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

Transport: Streamable HTTP (MCP 2025-03-26 compatible). No authentication required.

🔌 Client configuration

Add this to your MCP client's mcpServers configuration (Claude Desktop, Cursor, Cline, Cherry Studio, etc.):

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

Clients that do not accept "type": "http" accept the same entry with just "url".

🧰 Tools

| Tool | Parameters | Returns | |

---|---|---| | query_stock_quote(stock) | stock: stock code (sh600519, SH600519, 600519, 000858) or Chinese name (贵州茅台, 宁德时代). | Name, code, current price, prev close, open, high/low, change amount & percent, direction (涨/跌/平), volume (shares & lots), turnover, update time, data source. | | query_index() | (none) | The three major A-share indices — 上证指数 / 深证成指 / 创业板指: points, change, open/prev-close/high/low, plus an overall market-trend summary (全面上涨 / 多数下跌 etc.). |

Examples

• "贵州茅台现在多少钱？" → live quote for Kweichow Moutai.
• "查一下 300750" → quote for CATL (宁德时代).
• "今天大盘怎么样？" → the three indices and market trend.

📡 Data sources

• Primary: Tencent Finance real-time quote endpoint (qt.gtimg.cn) — free public interface, GBK encoded, no key.
• Fallback: Sina Finance (hq.sinajs.cn, sent with a Referer header) — automatically used if the primary source fails.
• Name → code resolution uses Tencent's suggest API, with a bundled map of ~50 common stocks for instant lookup.
• All requests have timeouts and graceful degradation; no API key or registration required.

Data is for informational purposes only and is delayed / indicative per the data providers; it is not investment advice.

🐢 Self-hosting

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

Then point your MCP client at http://127.0.0.1:8000/mcp.

With uv:

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

🗂️ Files

• stock_server.py — the MCP server: code/name resolution, Tencent + Sina quote parsing, FastMCP tool definitions.
• server.py — standalone Streamable HTTP entry point (serves the MCP app at /mcp).
• requirements.txt — Python dependencies.
• LICENSE — MIT.

---

🇨🇳 中文说明

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

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

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

📄 License

MIT © 2026 boy-373 (刘扶阳)