How do I install Akshare One?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Akshare One need an API key?

No required environment variable is listed on this record.

What transport does Akshare One use?

Akshare One runs locally over stdio.

When was Akshare One last checked?

Last checked 2026-11-10. MCP server that provides access to Chinese stock market data using akshare-one

Akshare One MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx akshare-one-mcp==0.5.0

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.zwldarren-akshare-one-mcp -- uvx akshare-one-mcp==0.5.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.zwldarren-akshare-one-mcp": {4      "command": "uvx",5      "args": [6        "akshare-one-mcp==0.5.0"7      ]8    }9  }10}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.5.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

Automatic source fallback

Except for get_inner_trade_data, whose upstream exposes a single source, every data 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` → `ths`
Real-time	`eastmoney_direct` → `eastmoney` → `xueqiu` → `ths` (the last two are skipped when no symbol is given)
News	`eastmoney` → `ths`
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.

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', 'ths') (default: 'eastmoney')
fallback (boolean, optional): Try 'eastmoney', 'eastmoney_direct', 'sina' and 'ths' 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.

symbol (string, optional): Stock code
source (string, optional): Data source ('eastmoney_direct', 'eastmoney', 'xueqiu', 'ths') (default: 'eastmoney_direct')
fallback (boolean, optional): Try 'eastmoney_direct', 'eastmoney', 'xueqiu' and 'ths' in order when the chosen source fails or has no data (default: true; 'xueqiu' and 'ths' are skipped when no symbol is given, as they quote one symbol at a time)

News & Information Tools

`get_news_data`

Get stock-related news data.

symbol (string, required): Stock code
source (string, optional): Data source ('eastmoney', 'ths') (default: 'eastmoney')
fallback (boolean, optional): Try 'eastmoney' and 'ths' in order when the chosen source fails or has no data (default: true)
recent_n (number, optional): Number of most recent records to return, newest first (default: 10)

Financial Statement Tools

`get_balance_sheet`

Get company balance sheet data.

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.

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.

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.

symbol (string, required): Stock code

`get_financial_metrics`

Get key financial metrics from the three major financial statements.

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

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.

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.

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

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)

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Akshare One?

Does Akshare One need an API key?

What transport does Akshare One use?

When was Akshare One last checked?

Documentation

AKShare One MCP Server

Overview

Available Tools

Automatic source fallback

Market Data Tools

get_hist_data

get_realtime_data

News & Information Tools

get_news_data

Financial Statement Tools

get_balance_sheet

get_income_statement

get_cash_flow

Analysis & Metrics Tools

get_inner_trade_data

get_financial_metrics

get_time_info

Installation & Setup

Running Modes

Installation Options

Option 1: Via Smithery

Option 2: Via uv

Option 3: Local Development Setup

Technical Indicators Reference

Trend Indicators

Momentum Indicators

Volatility Indicators

Volume Indicators

Other Indicators

`get_hist_data`

`get_realtime_data`

`get_news_data`

`get_balance_sheet`

`get_income_statement`

`get_cash_flow`

`get_inner_trade_data`

`get_financial_metrics`

`get_time_info`

Option 2: Via `uv`