MCP server that provides access to Chinese stock market data using akshare-one
This MCP server provides access to Chinese stock market data using akshare-one. It is identified by the slug io-github-zwldarren-akshare-one-mcp and serves as an integration layer for retrieving relevant market information through the Model Context Protocol.
π οΈ Key Features
Access to Chinese stock market data
Uses akshare-one as the data source/provider
π Use Cases
Querying Chinese stock market data via MCP
Integrating akshare-one-based market data into MCP-driven applications
β‘ Developer Benefits
Standardizes access to akshare-one data through an MCP server
Enables developer workflows centered on MCP tool access for stock market data
β οΈ Limitations
Available information does not specify supported endpoints/tools, schemas, authentication, rate limits, or coverage beyond βChinese stock market dataβ
An MCP server based on akshare-one, providing comprehensive interfaces for China stock market data. It offers a set of powerful tools for retrieving financial information including historical stock data, real-time data, news data, and financial statements.
Except for get_news_data and get_inner_trade_data, whose upstream exposes a single source, every tool takes a source parameter for the preferred data source and a fallback parameter (on by default) that decides whether the other sources of the same domain are tried when that source raises or returns an empty frame:
Domain
Order tried
Historical
eastmoney β eastmoney_direct β sina
Real-time
eastmoney_direct β eastmoney β xueqiu (skipped when no symbol is given)
Financial statements
sina β eastmoney_direct
The requested source is always tried first; the order only governs the fallback. Because akshare-one projects every source onto its domain's declared columns, falling back cannot change the field names or their order. When every source fails, the error lists each one and why it failed; when every source succeeds but has no data, an empty result is returned. Set fallback to false to pin a single source β a failure then surfaces directly, which is useful when you need to know exactly where the numbers came from.
The source that actually served a call is logged under the akshare_one_mcp.providers logger.
Market Data Tools
get_hist_data
Get historical stock market data with support for multiple time periods and adjustment methods.
Parameters
symbol (string, required): Stock code (e.g. '000001')
interval (string, optional): Time interval ('minute','hour','day','week','month','year') (default: 'day')
start_date (string, optional): Start date in YYYY-MM-DD format (default: '1970-01-01')
end_date (string, optional): End date in YYYY-MM-DD format (default: '2030-12-31')
adjust (string, optional): Adjustment type ('none', 'qfq', 'hfq') (default: 'none')
source (string, optional): Data source ('eastmoney', 'eastmoney_direct', 'sina') (default: 'eastmoney')
fallback (boolean, optional): Try 'eastmoney', 'eastmoney_direct' and 'sina' in order when the chosen source fails or has no data (default: true)
indicators_list (list, optional): Technical indicators to add
recent_n (number, optional): Number of most recent records to return (default: 100)
get_realtime_data
Get real-time stock market data.
Parameters
symbol (string, optional): Stock code
source (string, optional): Data source ('eastmoney_direct', 'eastmoney', 'xueqiu') (default: 'eastmoney_direct')
fallback (boolean, optional): Try 'eastmoney_direct', 'eastmoney' and 'xueqiu' in order when the chosen source fails or has no data (default: true; 'xueqiu' is skipped when no symbol is given, as it quotes one symbol at a time)
News & Information Tools
get_news_data
Get stock-related news data.
Parameters
symbol (string, required): Stock code
recent_n (number, optional): Number of most recent records to return (default: 10)
Financial Statement Tools
get_balance_sheet
Get company balance sheet data.
Parameters
symbol (string, required): Stock code
source (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'sina')
fallback (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
recent_n (number, optional): Number of most recent records to return (default: 10)
get_income_statement
Get company income statement data.
Parameters
symbol (string, required): Stock code
source (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'sina')
fallback (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
recent_n (number, optional): Number of most recent records to return (default: 10)
get_cash_flow
Get company cash flow statement data.
Parameters
symbol (string, required): Stock code
source (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'sina')
fallback (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
recent_n (number, optional): Number of most recent records to return (default: 10)
Analysis & Metrics Tools
get_inner_trade_data
Get company insider trading data.
Parameters
symbol (string, required): Stock code
get_financial_metrics
Get key financial metrics from the three major financial statements.
Parameters
symbol (string, required): Stock code
source (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'eastmoney_direct')
fallback (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
recent_n (number, optional): Number of most recent records to return (default: 10)
get_time_info
Get current time with ISO format, timestamp, and the last trading day.
Installation & Setup
Running Modes
The server supports two modes: stdio and streamable-http
--host: Host to bind to in HTTP mode (default: 0.0.0.0)
--port: Port to listen on in HTTP mode (default: 8081)
Note: When using streamable-http mode, the MCP server will be available at http://{host}:{port}/mcp. For the default configuration, this would be http://0.0.0.0:8081/mcp.
Installation Options
Option 1: Via Smithery
To install akshare-one-mcp for Claude Desktop automatically via Smithery:
bash
npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude
