AKShare One

You can run the AKShare One MCP Server to access a comprehensive set of China stock market data via MCP protocol. It gathers historical data, real-time data, news, and financial statements through a modular set of tools that you can query from an MCP client. This guide walks you through practical usage, installation steps, and configuration to get started quickly.

How to use

Use an MCP client to connect to the server and request data through the available tools. You can retrieve historical market data with various intervals and adjustments, fetch real-time quotes, pull stock-related news, and obtain financial statements such as balance sheets, income statements, and cash flows. You can also access internal trading data and compute key financial metrics and time information for current trading days.

How to install

Prerequisites you need before installation: Node.js and a working MCP client environment. You will also use the MCP runtime tool UV to run the local server configuration.

Option 2: Via UVX (local MCP runtime)
Follow these commands to configure a local MCP entry that runs akshare-one-mcp with UVX.

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

Option 3: Local Development Setup with UV (full start command)

If you are developing locally, run the server using UV with a direct directory path to the project and the standard run command.

{
  "mcpServers": {
    "akshare-one-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/akshare-one-mcp",
        "run",
        "akshare-one-mcp"
      ]
    }
  }
}

Notes on running modes and defaults

The server supports two modes: stdio and streamable-http. In HTTP mode, you can specify --streamable-http and provide host and port values for binding. If you use the default stdio mode, no HTTP URL is required.

Additional configuration and tips

If you want to access the full range of data, you will interact with the following tools: 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, and get_time_info. Each tool supports its own set of parameters, such as symbol codes, date ranges, data sources, and recent record limits. Use the MCP client to pass these parameters and receive structured results.

Security and environment considerations

Run the server in a controlled environment and keep the runtime that executes akshare-one-mcp isolated from untrusted networks. Do not expose internal APIs directly to the public internet without appropriate access controls. If you store credentials or API keys for data sources, protect them using your organization’s secret management practices.

Available tools

get_hist_data

Fetch historical stock market data with configurable interval, date range, adjustment type, data source, and optional technical indicators.

get_realtime_data

Retrieve current real-time stock data from selected data sources.

get_news_data

Obtain stock-related news records with a limit on the number of recent items.

get_balance_sheet

Get the latest balance sheet data for a given symbol.

get_income_statement

Get the latest income statement data for a given symbol.

get_cash_flow

Get cash flow statement data for a given symbol from a chosen source.

get_inner_trade_data

Access insider trading data for a company.

get_financial_metrics

Fetch key financial metrics derived from major financial statements.

get_time_info

Return current ISO time, timestamp, and last trading day.