Skip to main content
Glama
ashare-mcp

ashare-mcp

by maimai-hqw

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.

It also ships two disclosure-announcement (公告) tools backed by EastMoney's public HTTP APIs — list announcements for a stock and download the PDF — since baostock has no announcement surface. EastMoney's endpoints are reachable outside mainland China, so these work even when baostock's data port is blocked.

The data layer sits behind a DataProvider abstraction. v1 ships the baostock backend, with the seam in place to add other sources later without touching the tool layer. The announcement tools live alongside the provider (they don't go through baostock at all).

Install

uv sync

Related MCP server: sfc-data-mcp

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

Disclosure (EastMoney)

get_stock_announcements download_stock_announcement

Utility

get_current_time

Every baostock-backed data tool returns a uniform shape: {"count": int, "fields": [...], "data": [{...}, ...]}. The announcement tools return their own shape (see below).

Disclosure announcements (公告)

Two EastMoney-backed tools, independent of baostock:

  • get_stock_announcements(code, start_date="", end_date="", page_size=50, keyword="") — list a stock's announcements newest-first. code accepts sh.600519 / sz.002049 / 600519. start_date / end_date are inclusive YYYY-MM-DD filters. keyword is a case-sensitive substring on the title (e.g. 重组). Returns {code, count, data:[{art_code, title, notice_date, type, pdf_url_guess}]}.

  • download_stock_announcement(art_code, save_dir="") — download the announcement PDF by the art_code returned above. Resolves the real attachment URL via EastMoney's content API (falls back to the H2_<art_code>_1.pdf convention if needed). Returns {art_code, title, save_dir, files:[{path, url, bytes}]} — open the returned path with the MCP client's file/Read tool to read the PDF.

Typical flow: call get_stock_announcements → pick an art_code → download_stock_announcement → read the saved PDF.

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.

ASHARE_DOWNLOAD_DIR

~/.cache/ashare-mcp/announcements

Where download_stock_announcement saves PDFs. Set this in your MCP client config to point downloads at a project folder. An explicit save_dir arg to the tool always wins.

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 baostock tools start timing out, check this first. The EastMoney announcement tools use a separate HTTPS endpoint and are typically reachable outside CN.

  • 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.

  • The announcement tools are stdlib-only (no new dependencies) and run off the baostock session, so they keep working even if baostock is down.

Available Tools

24 tools
get_adjust_factorC

Price adjustment factors (复权因子, baostock 涨跌幅复权算法). Fields: code, dividOperateDate, foreAdjustFactor, backAdjustFactor, adjustFactor.

Inputs: code (required), start_date, end_date.

get_all_stockA

All securities and their trading status on a given day (default: latest trading day). day format 'YYYY-MM-DD'. Fields: code, tradeStatus (1可交易/0停牌), code_name.

Inputs: day.

get_balance_dataC

Quarterly solvency / balance-sheet ratios (季频偿债能力). quarter 1..4. Fields: currentRatio, quickRatio, cashRatio, YOYLiability, liabilityToAsset, assetToEquity.

Inputs: code (required), year, quarter.

get_cash_flow_dataC

Quarterly cash-flow ratios (季频现金流量). quarter 1..4. Fields: CAToAsset, NCAToAsset, tangibleAssetToAsset, ebitToInterest, CFOToOR, CFOToNP, CFOToGr.

Inputs: code (required), year, quarter.

get_current_timeA

Current local server time as 'YYYY-MM-DD HH:MM:SS'. Useful for building relative date ranges (e.g. 'last 30 days') for the date parameters below.

Inputs: no named parameters. Returns: result

get_deposit_rate_dataC

Benchmark deposit rates (存款利率) over a date range.

Inputs: start_date, end_date.

get_dividend_dataC

Dividend / rights-issue records. yearType: 'report'(预案公告年, default) / 'operate'(除权除息年) / 'dividend'(分红年). Fields include dividCashPsBeforeTax/AfterTax, dividStocksPs, dividRegistDate, dividOperateDate, dividPayDate.

Inputs: code (required), year, yearType.

get_dupont_dataC

Quarterly DuPont decomposition (季频杜邦指数). quarter 1..4. Fields: dupontROE, dupontAssetStoEquity, dupontAssetTurn, dupontPnitoni, dupontNitogr, dupontTaxBurden, dupontIntburden, dupontEbittogr.

Inputs: code (required), year, quarter.

get_forecast_reportC

Earnings forecast / pre-announcements (业绩预告) in [start_date, end_date]. Fields include profitForcastExpStatDate, profitForcastType, profitForcastChgPctUp/Dwn.

Inputs: code (required), start_date, end_date.

get_growth_dataC

Quarterly growth (季频成长能力). quarter 1..4. Fields: YOYEquity, YOYAsset, YOYNI, YOYEPSBasic, YOYPNI, YOYOperation.

Inputs: code (required), year, quarter.

get_history_k_dataA

Historical K-line bars. frequency: d=日 w=周 m=月 5/15/30/60=分钟线. adjustflag: 1后复权 2前复权 3不复权(默认). Dates 'YYYY-MM-DD'. fields is auto-selected per frequency (daily includes peTTM/pbMRQ/psTTM/pcfNcfTTM/turn/pctChg; minute adds a time column); pass a comma-separated fields string only to override.

Inputs: code (required), start_date, end_date, frequency, +2 more.

get_hs300_stocksC

CSI 300 (沪深300) constituents on date (default latest). Fields: updateDate, code, code_name.

Inputs: date.

get_loan_rate_dataC

Benchmark loan rates (贷款利率) over a date range.

Inputs: start_date, end_date.

get_money_supply_data_monthB

Monthly money supply M0/M1/M2 (货币供应量-月). Dates 'YYYY-MM'.

Inputs: start_date, end_date.

get_money_supply_data_yearB

Yearly money supply M0/M1/M2 (货币供应量-年). Dates 'YYYY'.

Inputs: start_date, end_date.

get_operation_dataC

Quarterly operating capability (季频营运能力). quarter 1..4. Fields: NRTurnRatio, NRTurnDays, INVTurnRatio, INVTurnDays, CATurnRatio, AssetTurnRatio.

Inputs: code (required), year, quarter.

get_performance_express_reportC

Performance express reports (业绩快报) filed in [start_date, end_date]. Fields include performanceExpStatDate, performanceExpressROEWa, performanceExpressEPSChgPct.

Inputs: code (required), start_date, end_date.

get_profit_dataC

Quarterly profitability (季频盈利能力). quarter 1..4. Fields: roeAvg, npMargin, gpMargin, netProfit, epsTTM, MBRevenue, totalShare, liqaShare.

Inputs: code (required), year, quarter.

get_required_reserve_ratio_dataC

Required reserve ratio (存款准备金率). yearType: 0生效日期(default)/1公告日期.

Inputs: start_date, end_date, yearType.

get_stock_basicA

Basic securities profile. Pass code (e.g. 'sh.600519') OR code_name (Chinese name). Empty both -> all securities. Fields: code, code_name, ipoDate, outDate, type (1股票/2指数/3其它), status (1上市/0退市).

Inputs: code, code_name.

get_stock_industryB

Industry classification (申万). Empty code -> whole market. Fields: updateDate, code, code_name, industry, industryClassification.

Inputs: code, date.

get_sz50_stocksB

SSE 50 (上证50) constituents on date (default latest). Fields: updateDate, code, code_name.

Inputs: date.

get_trade_datesB

Trading-calendar flags between two dates (default: from 2015-01-01). Fields: calendar_date, is_trading_day (1是/0否).

Inputs: start_date, end_date.

get_zz500_stocksB

CSI 500 (中证500) constituents on date (default latest). Fields: updateDate, code, code_name.

Inputs: date.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 24 tools

    Disambiguation5/5

    Each tool retrieves a distinct set of financial data (e.g., balance sheet ratios, cash flow, dividends, K-line, index constituents). Descriptions are detailed and clearly separate overlapping concepts like different ratio types or index members.

    Naming Consistency5/5

    All tool names follow a consistent 'get_<data_type>_<optional_modifier>' pattern using snake_case, making it easy for an agent to infer purpose from the name alone.

    Tool Count4/5

    At 24 tools, the count is slightly above the ideal range but still justified given the broad domain coverage (fundamentals, technicals, macro, market indices). Each tool addresses a specific data need without redundancy.

    Completeness4/5

    Covers a wide range of A-share market data: financial ratios, K-line, dividends, forecasts, banking rates, money supply, and index constituents. Minor gaps like real-time quotes or SEC filings are understandable for a historical/derived data server.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server that wraps SFC financial data API into 32 tools for comprehensive A-share market data, including real-time quotes, rankings, limit-up statistics, news, themes, financials, charts, research reports, and watchlists.
      -
    • A
      license
      B
      quality
      D
      maintenance
      MCP server exposing 43 financial data tools for A-share, HK, US stocks, crypto, and market news via open-stock-data.
      43
      63 PyPI
      15
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      MCP server that wraps AKShare's 1000+ financial data functions, enabling LLMs to query Chinese stock, macro, futures, fund, bond, option, forex, and alternative data through standardized tools.
      14
      3
      Apache 2.0