AKShare One MCP Server

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:

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.

Get historical stock market data with support for multiple time periods and adjustment methods.

Get real-time stock market data.

Get stock-related news data.

Get company balance sheet data.

Get company income statement data.

Get company cash flow statement data.

Get company insider trading data.

Get key financial metrics from the three major financial statements.

Get current time with ISO format, timestamp, and the last trading day.

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 be http://0.0.0.0:8081/mcp.

To install akshare-one-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude

Install uv if you haven't already.

uvx installs the package from PyPI and runs it on Python 3.12 or newer.

Add the following configuration to your MCP Client settings:

{
  "mcpServers": {
    "akshare-one-mcp": {
      "command": "uvx",
      "args": ["akshare-one-mcp"]
    }
  }
}

1. Clone this repository:

   git clone https://github.com/zwldarren/akshare-one-mcp.git
   cd akshare-one-mcp

2. Install dependencies:

   uv sync

3. 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"
         ]
       }
     }
   }

The get_hist_data tool supports the following technical 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)

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

• Bollinger Bands: BOLL (Bollinger Bands)
• Average True Range: ATR (Average True Range)
• Parabolic SAR: SAR (Parabolic Stop and Reverse)

• Volume: OBV (On-Balance Volume), AD (Accumulation/Distribution Line), ADOSC (Accumulation/Distribution Oscillator)

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