Zwldarren Akshare One MCP

What zwldarren-akshare-one-mcp does

zwldarren-akshare-one-mcp connects MCP-compatible clients with Chinese stock-market data through the akshare-one project. Its tools cover price history, current quotes, stock-related news, company financial statements, insider trading activity, financial metrics, and time information related to trading days.

Historical data can be requested by stock code, interval, date range, and adjustment mode. Supported intervals include minute, hour, day, week, month, and year. The historical-data tool can also limit the result to recent records and add requested technical indicators. The eastmoney_direct source supports A, B, and H shares for this tool.

How it works

The server runs as an MCP process in either standard input/output mode or streamable HTTP mode. In HTTP mode, clients connect to the /mcp endpoint on the configured host and port.

Most data tools accept a preferred source and a fallback option. With fallback enabled, the requested source is attempted first; other sources for the same data domain are tried if the request raises an error or produces an empty result. The available source order depends on the tool. Historical data can use Eastmoney, direct Eastmoney, Sina, and THS; real-time data can use direct Eastmoney, Eastmoney, Xueqiu, and THS; news uses Eastmoney and THS; and financial statements use Sina and direct Eastmoney. Xueqiu and THS are skipped for real-time requests without a symbol.

Disabling fallback pins the request to one source, so a source failure is returned directly. The source that handled a request is written to the akshare_one_mcp.providers logger. If all sources fail, the error reports the attempted sources and their failures; if they succeed without records, the result is empty.

Setup and configuration

The package can be run from PyPI with uvx and requires Python 3.12 or newer. A standard MCP client configuration uses the akshare-one-mcp command:

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

For local development, clone the repository, run uv sync, and configure the client to execute uv run with the repository path. Smithery provides an installation command for Claude Desktop.

The default mode is stdio. Add --streamable-http to use HTTP, with --host and --port available for binding configuration. The default HTTP port is 8081, and the MCP endpoint is /mcp.

Tools and capabilities

• get_hist_data returns historical market records with date, interval, adjustment, recent-record, and indicator options.
• get_realtime_data retrieves current market data for a symbol or broader real-time requests supported by the selected source.
• get_news_data returns recent stock-related news, newest first.
• get_balance_sheet, get_income_statement, and get_cash_flow retrieve the three main company financial statements.
• get_financial_metrics returns key metrics derived from those statements.
• get_inner_trade_data retrieves company insider trading information.
• get_time_info returns ISO time, a timestamp, and the last trading day.

Limitations and notes

Requests identify securities with stock codes. Source availability and returned records depend on the selected upstream provider. Automatic fallback is available for the data tools except insider trading, which uses a single upstream source. The source used for a request may differ from the preferred source when fallback is enabled, although the data fields remain projected onto the domain's declared columns.