# zwldarren-akshare-one-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/zwldarren/akshare-one-mcp  
**GitHub Stars:** 246  
**Views:** 18  
**Installs:** 1  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/zwldarren-akshare-one-mcp

## Description
Provide access to Chinese stock market data including historical prices, real-time data, news, and…

## Tools
Capabilities this server exposes over MCP:

- **get_hist_data** — Get historical stock market data. 'eastmoney_direct' support all A,B,H shares

With fallback on, the sources are tried as 'eastmoney', 'eastmoney_direct',
'sina' and 'ths', starting with the requested one.
- **get_realtime_data** — Get real-time stock market data. 'eastmoney_direct' support all A,B,H shares

With fallback on, the sources are tried as 'eastmoney_direct', 'eastmoney',
'xueqiu' and 'ths', starting with the requested one.
- **get_news_data** — Get stock-related news data.

With fallback on, the sources are tried as 'eastmoney' and 'ths', starting
with the requested one.
- **get_balance_sheet** — Get company balance sheet data.

With fallback on, the sources are tried as 'sina' and 'eastmoney_direct',
starting with the requested one.
- **get_income_statement** — Get company income statement data.

With fallback on, the sources are tried as 'sina' and 'eastmoney_direct',
starting with the requested one.
- **get_cash_flow** — Get company cash flow statement data.

With fallback on, the sources are tried as 'sina' and 'eastmoney_direct',
starting with the requested one.
- **get_inner_trade_data** — Get company insider trading data.
- **get_financial_metrics** — Get key financial metrics from the three major financial statements.

With fallback on, the sources are tried as 'sina' and 'eastmoney_direct',
starting with the requested one.
- **get_time_info** — Get current time with ISO format, timestamp, and the last trading day.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

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

## Documentation

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

```json
{
  "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.

_Full upstream README: https://allmcps.com/mcp/zwldarren-akshare-one-mcp/readme_