io.github.zwldarren/akshare-one-mcp MCP Server

io.github.zwldarren/akshare-one-mcp

Access Chinese stock market data with historical prices, real-time quotes, financial statements, and insider trading information.

Repository Registry

What is the io.github.zwldarren/akshare-one-mcp MCP server?

The AKShare One MCP server provides comprehensive interfaces for retrieving Chinese stock market data through the akshare-one library. It offers tools for historical stock data, real-time quotes, financial statements, news, and insider trading information with automatic source fallback across multiple data providers.

This server gives AI agents access to Chinese financial market data including historical OHLCV data with technical indicators, real-time stock quotes, company financial statements (balance sheet, income statement, cash flow), news data, and insider trading activity. It's useful for financial analysis, investment research, market monitoring, and building trading or analysis applications that need reliable Chinese stock data.

How to install io.github.zwldarren/akshare-one-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

~/Library/Application Support/Claude/claude_desktop_config.json

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

Tools & capabilities

Tools this server exposes to the agent.

get_hist_data — Retrieve historical stock market data with support for multiple time intervals (minute, hour, day, week, month, year), adjustment methods (none, qfq, hfq), and technical indicators.
get_realtime_data — Get real-time stock market data with optional symbol filtering from multiple sources (eastmoney_direct, eastmoney, xueqiu).
get_news_data — Fetch stock-related news data for a given stock symbol.
get_balance_sheet — Retrieve company balance sheet financial statement data.
get_income_statement — Get company income statement financial data.
get_cash_flow — Obtain company cash flow statement information.
get_inner_trade_data — Access company insider trading data.
get_financial_metrics — Get key financial metrics derived from the three major financial statements.
get_time_info — Retrieve current time in ISO format, timestamp, and the last trading day.

Use cases

Analyze historical stock price trends with technical indicators like MACD, RSI, and Bollinger Bands for a Chinese stock
Monitor real-time stock quotes and market data across multiple Chinese exchanges
Research company fundamentals by retrieving balance sheets, income statements, and cash flow data
Track insider trading activity to identify significant company insider transactions
Build financial dashboards or trading systems that aggregate Chinese market data from multiple sources

io.github.zwldarren/akshare-one-mcp MCP server FAQ

What is the AKShare One MCP server?

It's an MCP server that provides access to Chinese stock market data including historical prices, real-time quotes, financial statements, news, and insider trading information through the akshare-one library.

Is this server free to use?

The server itself is open-source and free (MIT licensed), though the underlying data sources (eastmoney, sina, xueqiu) may have their own terms of service.

How do I install this in Claude Desktop?

You can install it via Smithery with `npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude`, or manually add it to your MCP settings using `uvx akshare-one-mcp` as the command.

Does it require authentication?

No authentication is required; the server connects directly to public Chinese stock market data sources.

What data sources does it use?

It pulls from multiple sources including Eastmoney, Sina, and Xueqiu, with automatic fallback to alternative sources if the primary source fails or returns no data.

Can I specify which data source to use?

Yes, each tool accepts a `source` parameter to prefer a specific provider, and a `fallback` parameter (enabled by default) to automatically try other sources if the chosen one fails.

README (reference)

Source of truth, from the repository.

AKShare One MCP Server

<div align="center"> <a href="README.md">English</a> | <a href="README_zh.md">中文</a> </div>

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_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:

Domain	Order tried
Historical	`eastmoney` → `eastmoney_direct` → `sina`
Real-time	`eastmoney_direct` → `eastmoney` → `xueqiu` (skipped when no symbol is given)
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.