Happy slice of mcp pizzaMCP.pizza

akshare-one-mcp

MCP.Pizza Chef: zwldarren

Nine read-only tools cover mainland China's listed companies: price history by minute, day, or month, live quotes, company news, balance sheets, income statements, cash flow, insider dealing, headline financial ratios, and today's trading date. Nothing is ever written back, and there is no account to open or key to paste, because the figures come from public Chinese finance sites. Shares listed outside mainland China are not covered, and you look companies up by their number rather than by a name.

Data
Web/Research

Use This MCP server To

Compare three Chinese companies on profit and debt Pull a year of daily prices and spot the trend Check today's price for a stock I follow Read the latest news about a listed company See whether company insiders have been buying or selling Summarize a company's cash position over recent years

README

AKShare One MCP Server

English | 中文

smithery badge

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.

akshare-one-mcp MCP server

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 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 ('xueqiu', 'eastmoney', 'eastmoney_direct') (default: 'eastmoney_direct')

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

Add the following configuration to your MCP Client settings:

{
  "mcpServers": {
    "akshare-one-mcp": {
      "command": "uvx",
      "args": ["akshare-one-mcp"]
    }
  }
}
Option 3: Local Development Setup

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

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)

akshare-one-mcp FAQ

Do I need a key or a paid account?
No. Nothing to sign up for and nothing to pay. The figures are pulled from public Chinese finance sites, which is unusual for a market data tool.
Can I use this to look up Apple or Tesla?
No. Coverage is mainland China only, meaning the Shanghai and Shenzhen exchanges. Companies listed elsewhere will simply not be found.
Can it buy or sell anything for me?
No. Every tool only reads. There is no trading, no order placing, and no connection to a brokerage account.
How do I refer to a company?
By its numeric stock code, such as 600519, rather than its name. Ask your assistant to look up the code first if you do not know it.
How hard is it to set up?
Easy. Paste a two-line block into your app's settings, or let Smithery install it for you. Nothing else to configure.
Which apps does it work in?
Claude Desktop is documented, and it will run in any app that accepts a standard MCP settings block. It can also be run as a shared service on your own network.
How reliable is the data?
It is scraped from public sites such as Eastmoney and Sina rather than bought from an official provider, so an occasional gap or failed lookup is normal, and prices may lag the exchange slightly.