How do I use ashare-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ashare-mcp list HS300 constituents" 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.

English | 简体中文

ashare-mcp

An MCP server built on baostock that exposes all 23 baostock data endpoints as MCP tools: K-line, quarterly financials (profit / operation / growth / balance / cash-flow / DuPont), performance express & forecast reports, dividends, adjust factors, industry classification, index constituents, the trading calendar, and macro series.

The data layer sits behind a DataProvider abstraction. v1 ships the baostock backend, with the seam in place to add other sources (e.g. eastmoney) later without touching the tool layer.

Install

uv sync

Run (stdio)

uv run ashare-mcp

Configure it in a stdio MCP client (Claude Desktop / Claude Code / Cursor):

{
  "mcpServers": {
    "ashare": {
      "command": "uv",
      "args": ["--directory", "/path/to/ashare-mcp", "run", "ashare-mcp"]
    }
  }
}

Tools

Category	Tools
Market	`get_stock_basic` `get_all_stock` `get_trade_dates` `get_history_k_data`
Dividend / adjust	`get_dividend_data` `get_adjust_factor`
Quarterly financials	`get_profit_data` `get_operation_data` `get_growth_data` `get_balance_data` `get_cash_flow_data` `get_dupont_data`
Reports	`get_performance_express_report` `get_forecast_report`
Industry / constituents	`get_stock_industry` `get_sz50_stocks` `get_hs300_stocks` `get_zz500_stocks`
Macro	`get_deposit_rate_data` `get_loan_rate_data` `get_required_reserve_ratio_data` `get_money_supply_data_month` `get_money_supply_data_year`
Utility	`get_current_time`

Every data tool returns a uniform shape: {"count": int, "fields": [...], "data": [{...}, ...]}.

Codes

Pass baostock-form codes: sh.600519, sz.000001, bj.430047. Bare 6-digit codes (e.g. 600519) are normalized best-effort, but ambiguous index codes (e.g. 000001 is both SSE Composite sh.000001 and Ping An Bank sz.000001) should be passed with an explicit prefix.

Configuration

Env var	Default	Meaning
`ASHARE_SOURCE`	`baostock`	Data backend. Only `baostock` in v1.

Development

uv run pytest -q              # unit tests (no network)
uv run pytest -q -m network   # live baostock smoke test

Notes

baostock's data port must be reachable from your network (reachable inside mainland China; may time out elsewhere). If tools start timing out, check this first.
baostock needs no registration, but each process still must call bs.login() to open a session — this server logs in once and logs out on shutdown.