AKShare One MCP Server
Overview
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.
Available Tools
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')interval_multiplier(number, optional): Interval multiplier (default: 1)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')indicators_list(list, optional): Technical indicators to addrecent_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 codesource(string, optional): Data source ('xueqiu', 'eastmoney', 'eastmoney_direct') (default: 'eastmoney_direct')
News & Information Tools
get_news_data
Get stock-related news data.
Parameters
symbol(string, required): Stock coderecent_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 coderecent_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 coderecent_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 codesource(string, optional): Data source (default: 'sina')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 coderecent_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
Command Line Arguments:
--streamable-http: Enable HTTP mode (default: stdio mode)--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 behttp://0.0.0.0:8081/mcp.
Installation Options
Option 1: Via Smithery
To install akshare-one-mcp for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude
Option 2: Via uv
Install uv if you haven't already.
Add the following configuration to your MCP Client settings:
{
"mcpServers": {
"akshare-one-mcp": {
"command": "uvx",
"args": ["akshare-one-mcp"]
}
}
}
Option 3: Local Development Setup
-
Clone this repository:
git clone https://github.com/zwldarren/akshare-one-mcp.git cd akshare-one-mcp -
Install dependencies:
uv sync -
Add the following configuration to your MCP Client settings:
{ "mcpServers": { "akshare-one-mcp": { "command": "uv", "args": [ "--directory", "/path/to/akshare-one-mcp", "run", "akshare-one-mcp" ] } } }
Technical Indicators Reference
The get_hist_data tool supports the following technical indicators:
Trend Indicators
- Moving Averages: SMA (Simple Moving Average), EMA (Exponential Moving Average)
- Trend Tracking: MACD (Moving Average Convergence Divergence), APO (Absolute Price Oscillator), PPO (Percentage Price Oscillator)
- Rate of Change: ROC (Rate of Change), ROCP (Rate of Change Percentage), ROCR (Rate of Change Ratio), ROCR100
- Other: TRIX (Triple Exponential Moving Average), ULTOSC (Ultimate Oscillator)
Momentum Indicators
- Relative Strength: RSI (Relative Strength Index), CCI (Commodity Channel Index)
- Trend Strength: ADX (Average Directional Index), DX (Directional Index)
- Money Flow: MFI (Money Flow Index), MOM (Momentum), CMO (Chande Momentum Oscillator), WILLR (Williams %R)
Volatility Indicators
- Bollinger Bands: BOLL (Bollinger Bands)
- Average True Range: ATR (Average True Range)
- Parabolic SAR: SAR (Parabolic Stop and Reverse)
Volume Indicators
- Volume: OBV (On-Balance Volume), AD (Accumulation/Distribution Line), ADOSC (Accumulation/Distribution Oscillator)
Other Indicators
- Stochastic: STOCH (Stochastic Oscillator)
- Aroon: AROON (Aroon Indicator), AROONOSC (Aroon Oscillator)
- Balance of Power: BOP (Balance of Power)
- Directional Indicators: MINUS_DI, MINUS_DM, PLUS_DI, PLUS_DM
- Time Series Forecast: TSF (Time Series Forecast)