Repository avatar
Developer Tools
v1.0.0
active

astock-mcp-server

io.github.PHM-Audit/astock-mcp-server

A-share quant toolkit MCP: quotes, 60-pt scoring, signals, backtests. Public data, zero auth.

Documentation

astock-mcp-server

China A-share quant toolkit exposed as Model Context Protocol tools. Zero auth, public data sources, standard public indicators.

Tools

ToolInputReturns
stock_quotecode (e.g. "600519")realtime snapshot: price/open/high/low/change%/volume/PE
stock_scorecode60-point technical score + signal list (MA position, Bollinger band, RSI, KDJ, MACD, trend)
stock_signalscode, days=120multi-indicator resonance: bullish/bearish count, strength stars, per-indicator detail
stock_backtestcode, strategy, days=500total return, buy-and-hold, annualized, Sharpe, max drawdown, win rate, trade count

Available backtest strategies

ma_cross · bollinger_reversal · kdj_overtrade · rsi_meanreversion · macd_cross · fusion_ma_bollinger · fusion_boll_kdj · fusion_triple

Code format

Shanghai: 600519 (6xxxxx) · Shenzhen: 000001 / 300750 · auto-detected. Do not prefix with sh/sz.

Data sources

  • Realtime quotes: Tencent qt.gtimg.cn
  • Daily klines (qfq): EastMoney push2his.eastmoney.com (Tencent kline endpoint used as primary, EastMoney fallback on WAF throttling)
  • Rate limiting + TTL caching + exponential-backoff retry built in, safe for concurrent MCP clients

All indicators are standard public formulas (MA/RSI/MACD/KDJ/Bollinger). No proprietary logic is included.

Install

pip install astock-mcp-server

Claude Desktop / any MCP client config

{
  "mcpServers": {
    "astock-quant": {
      "command": "python",
      "args": ["-m", "astock_mcp_server_runner"]
    }
  }
}

Or run directly after cloning:

pip install mcp pandas numpy
python server.py

Example

{"tool": "stock_backtest", "args": {"code": "600519", "strategy": "rsi_meanreversion", "days": 500}}
{"总收益": "25.49%", "买入持有": "3.83%", "年化": "12.13%", "夏普": 0.86, "回撤": "-9.71%", "胜率": "52%", "交易": "17次"}

Disclaimer

Historical simulation and technical indicators for reference only. Not investment advice.

MCPB
https://github.com/PHM-Audit/astock-mcp-server/releases/download/v1.0.0/astock-mcp-server-mcpb-1.0.0.mcpb
Install Command
# mcpb: https://github.com/PHM-Audit/astock-mcp-server/releases/download/v1.0.0/astock-mcp-server-mcpb-1.0.0.mcpb