Skip to content
Back to search

akshare-one-mcp

MCP server that provides access to Chinese stock market data using akshare-one

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/zwldarren/akshare-one-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/zwldarren/akshare-one-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zwldarren--akshare-one-mcp/badge.svg)](/listings/zwldarren--akshare-one-mcp)

HTML

<a href="/listings/zwldarren--akshare-one-mcp"><img src="/api/listings/zwldarren--akshare-one-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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](https://smithery.ai/server/@zwldarren/akshare-one-mcp):

npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude

Option 2: Via `uv`

Install [uv](<https://docs.astral.sh/uv/getting-started/installation/>) if you haven't already.

`uvx` installs the package from [PyPI](https://pypi.org/project/akshare-one-mcp/) and runs it on Python 3.12 or newer.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 257 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # AKShare One MCP Server
  2. <div align="center">
  3. <a href="README.md">English</a> |
  4. <a href="README_zh.md">中文</a>
  5. </div>
  6. <!-- mcp-name: io.github.zwldarren/akshare-one-mcp -->
  7. [![smithery badge](https://smithery.ai/badge/@zwldarren/akshare-one-mcp)](https://smithery.ai/server/@zwldarren/akshare-one-mcp)
  8. [![PyPI version](https://img.shields.io/pypi/v/akshare-one-mcp)](https://pypi.org/project/akshare-one-mcp/)
  9. [![PyPI downloads](https://img.shields.io/pypi/dm/akshare-one-mcp)](https://pypi.org/project/akshare-one-mcp/)
  10. [![Python versions](https://img.shields.io/pypi/pyversions/akshare-one-mcp)](https://pypi.org/project/akshare-one-mcp/)
  11. [![License: MIT](https://img.shields.io/github/license/zwldarren/akshare-one-mcp)](https://github.com/zwldarren/akshare-one-mcp/blob/main/LICENSE)
  12. ## Overview
  13. An MCP server based on [akshare-one](https://github.com/zwldarren/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.
  14. <a href="https://glama.ai/mcp/servers/@zwldarren/akshare-one-mcp">
  15. <img width="380" height="200" src="https://glama.ai/mcp/servers/@zwldarren/akshare-one-mcp/badge" alt="akshare-one-mcp MCP server" />
  16. </a>
  17. ## Available Tools
  18. ### Automatic source fallback
  19. Except for `get_inner_trade_data`, whose upstream exposes a single source, every data 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**:
  20. | Domain | Order tried |
  21. | --- | --- |
  22. | Historical | `eastmoney` → `eastmoney_direct` → `sina` → `ths` |
  23. | Real-time | `eastmoney_direct` → `eastmoney` → `xueqiu` → `ths` (the last two are skipped when no symbol is given) |
  24. | News | `eastmoney` → `ths` |
  25. | Financial statements | `sina` ⇄ `eastmoney_direct` |
  26. 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.
  27. The source that actually served a call is logged under the `akshare_one_mcp.providers` logger.
  28. ### Market Data Tools
  29. #### `get_hist_data`
  30. Get historical stock market data with support for multiple time periods and adjustment methods.
  31. <details>
  32. <summary>Parameters</summary>
  33. - `symbol` (string, required): Stock code (e.g. '000001')
  34. - `interval` (string, optional): Time interval ('minute','hour','day','week','month','year') (default: 'day')
  35. - `interval_multiplier` (number, optional): Interval multiplier (default: 1)
  36. - `start_date` (string, optional): Start date in YYYY-MM-DD format (default: '1970-01-01')
  37. - `end_date` (string, optional): End date in YYYY-MM-DD format (default: '2030-12-31')
  38. - `adjust` (string, optional): Adjustment type ('none', 'qfq', 'hfq') (default: 'none')
  39. - `source` (string, optional): Data source ('eastmoney', 'eastmoney_direct', 'sina', 'ths') (default: 'eastmoney')
  40. - `fallback` (boolean, optional): Try 'eastmoney', 'eastmoney_direct', 'sina' and 'ths' in order when the chosen source fails or has no data (default: true)
  41. - `indicators_list` (list, optional): Technical indicators to add
  42. - `recent_n` (number, optional): Number of most recent records to return (default: 100)
  43. </details>
  44. #### `get_realtime_data`
  45. Get real-time stock market data.
  46. <details>
  47. <summary>Parameters</summary>
  48. - `symbol` (string, optional): Stock code
  49. - `source` (string, optional): Data source ('eastmoney_direct', 'eastmoney', 'xueqiu', 'ths') (default: 'eastmoney_direct')
  50. - `fallback` (boolean, optional): Try 'eastmoney_direct', 'eastmoney', 'xueqiu' and 'ths' in order when the chosen source fails or has no data (default: true; 'xueqiu' and 'ths' are skipped when no symbol is given, as they quote one symbol at a time)
  51. </details>
  52. ### News & Information Tools
  53. #### `get_news_data`
  54. Get stock-related news data.
  55. <details>
  56. <summary>Parameters</summary>
  57. - `symbol` (string, required): Stock code
  58. - `source` (string, optional): Data source ('eastmoney', 'ths') (default: 'eastmoney')
  59. - `fallback` (boolean, optional): Try 'eastmoney' and 'ths' in order when the chosen source fails or has no data (default: true)
  60. - `recent_n` (number, optional): Number of most recent records to return, newest first (default: 10)
  61. </details>
  62. ### Financial Statement Tools
  63. #### `get_balance_sheet`
  64. Get company balance sheet data.
  65. <details>
  66. <summary>Parameters</summary>
  67. - `symbol` (string, required): Stock code
  68. - `source` (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'sina')
  69. - `fallback` (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
  70. - `recent_n` (number, optional): Number of most recent records to return (default: 10)
  71. </details>
  72. #### `get_income_statement`
  73. Get company income statement data.
  74. <details>
  75. <summary>Parameters</summary>
  76. - `symbol` (string, required): Stock code
  77. - `source` (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'sina')
  78. - `fallback` (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
  79. - `recent_n` (number, optional): Number of most recent records to return (default: 10)
  80. </details>
  81. #### `get_cash_flow`
  82. Get company cash flow statement data.
  83. <details>
  84. <summary>Parameters</summary>
  85. - `symbol` (string, required): Stock code
  86. - `source` (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'sina')
  87. - `fallback` (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
  88. - `recent_n` (number, optional): Number of most recent records to return (default: 10)
  89. </details>
  90. ### Analysis & Metrics Tools
  91. #### `get_inner_trade_data`
  92. Get company insider trading data.
  93. <details>
  94. <summary>Parameters</summary>
  95. - `symbol` (string, required): Stock code
  96. </details>
  97. #### `get_financial_metrics`
  98. Get key financial metrics from the three major financial statements.
  99. <details>
  100. <summary>Parameters</summary>
  101. - `symbol` (string, required): Stock code
  102. - `source` (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'eastmoney_direct')
  103. - `fallback` (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
  104. - `recent_n` (number, optional): Number of most recent records to return (default: 10)
  105. </details>
  106. #### `get_time_info`
  107. Get current time with ISO format, timestamp, and the last trading day.
  108. ## Installation & Setup
  109. ### Running Modes
  110. The server supports two modes: stdio and streamable-http
  111. **Command Line Arguments:**
  112. - `--streamable-http`: Enable HTTP mode (default: stdio mode)
  113. - `--host`: Host to bind to in HTTP mode (default: 0.0.0.0)
  114. - `--port`: Port to listen on in HTTP mode (default: 8081)
  115. > **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`.
  116. ### Installation Options
  117. #### Option 1: Via Smithery
  118. To install akshare-one-mcp for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@zwldarren/akshare-one-mcp):
  119. ```bash
  120. npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude
  121. ```
  122. #### Option 2: Via `uv`
  123. Install [uv](<https://docs.astral.sh/uv/getting-started/installation/>) if you haven't already.
  124. `uvx` installs the package from [PyPI](https://pypi.org/project/akshare-one-mcp/) and runs it on Python 3.12 or newer.
  125. Add the following configuration to your MCP Client settings:
  126. ```json
  127. {
  128. "mcpServers": {
  129. "akshare-one-mcp": {
  130. "command": "uvx",
  131. "args": ["akshare-one-mcp"]
  132. }
  133. }
  134. }
  135. ```
  136. #### Option 3: Local Development Setup
  137. 1. Clone this repository:
  138. ```bash
  139. git clone https://github.com/zwldarren/akshare-one-mcp.git
  140. cd akshare-one-mcp
  141. ```
  142. 2. Install dependencies:
  143. ```bash
  144. uv sync
  145. ```
  146. 3. Add the following configuration to your MCP Client settings:
  147. ```json
  148. {
  149. "mcpServers": {
  150. "akshare-one-mcp": {
  151. "command": "uv",
  152. "args": [
  153. "--directory",
  154. "/path/to/akshare-one-mcp",
  155. "run",
  156. "akshare-one-mcp"
  157. ]
  158. }
  159. }
  160. }
  161. ```
  162. ## Technical Indicators Reference
  163. The `get_hist_data` tool supports the following technical indicators:
  164. ### Trend Indicators
  165. - **Moving Averages**: SMA (Simple Moving Average), EMA (Exponential Moving Average)
  166. - **Trend Tracking**: MACD (Moving Average Convergence Divergence), APO (Absolute Price Oscillator), PPO (Percentage Price Oscillator)
  167. - **Rate of Change**: ROC (Rate of Change), ROCP (Rate of Change Percentage), ROCR (Rate of Change Ratio), ROCR100
  168. - **Other**: TRIX (Triple Exponential Moving Average), ULTOSC (Ultimate Oscillator)
  169. ### Momentum Indicators
  170. - **Relative Strength**: RSI (Relative Strength Index), CCI (Commodity Channel Index)
  171. - **Trend Strength**: ADX (Average Directional Index), DX (Directional Index)
  172. - **Money Flow**: MFI (Money Flow Index), MOM (Momentum), CMO (Chande Momentum Oscillator), WILLR (Williams %R)
  173. ### Volatility Indicators
  174. - **Bollinger Bands**: BOLL (Bollinger Bands)
  175. - **Average True Range**: ATR (Average True Range)
  176. - **Parabolic SAR**: SAR (Parabolic Stop and Reverse)
  177. ### Volume Indicators
  178. - **Volume**: OBV (On-Balance Volume), AD (Accumulation/Distribution Line), ADOSC (Accumulation/Distribution Oscillator)
  179. ### Other Indicators
  180. - **Stochastic**: STOCH (Stochastic Oscillator)
  181. - **Aroon**: AROON (Aroon Indicator), AROONOSC (Aroon Oscillator)
  182. - **Balance of Power**: BOP (Balance of Power)
  183. - **Directional Indicators**: MINUS_DI, MINUS_DM, PLUS_DI, PLUS_DM
  184. - **Time Series Forecast**: TSF (Time Series Forecast)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.