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 aRefererheader) — 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 (刘扶阳)