Akshare One Mcp

io.github.zwldarren由 GitHub 帳號 zwldarren 發布v0.5.0更新於 Oct 24, 2026

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

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理以唯讀方式取得中國股市資料：歷史與即時行情、新聞、財務報表及財務指標。

可以做什麼
依股票代碼取得歷史行情，支援分鐘、小時、日、週、月、年等週期，可選復權方式與技術指標（如 SMA、MACD、RSI、布林通道），並可限制回傳最近若干筆記錄。取得即時行情，可指定單一股票或不指定代碼取得整體行情。讀取個股相關新聞，依時間由新到舊排列。取得資產負債表、損益表、現金流量表資料，以及由三大報表得出的關鍵財務指標。查詢內部人交易資料，並取得目前時間與最近交易日。
適用情境
適合助理需要回答中國上市公司與 A 股市場相關問題，例如歷史價格、近期新聞或已公布財務資料，而不必由使用者手動複製資料。不適用於非中國市場，也不提供交易下單功能。
執行需求
以 Python 套件（akshare-one-mcp）在本機執行，需 Python 3.12 或更新版本，可透過 uvx 執行，或複製儲存庫後以 uv 啟動。未宣告需要帳號、API 金鑰或環境變數。需要連網存取上游資料來源（eastmoney、sina、ths、xueqiu）。可透過命令列參數啟用選用的 HTTP 模式。
安裝前請注意
所有工具皆為唯讀查詢，但每次呼叫都會從第三方中文財經網站取得即時資料，因此查詢的股票代碼會傳送給這些提供者。資料品質與可用性取決於這些來源；伺服器預設會回退到其他來源，除非關閉 fallback，否則資料出處可能改變。輸出為市場資料，不構成投資建議。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Akshare One Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

AKShare One MCP Server

[smithery badge]

[PyPI version] [PyPI downloads] [Python versions] [License: MIT]

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.

[akshare-one-mcp MCP server]

Available Tools

Automatic source fallback

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:

DomainOrder tried
Historicaleastmoney → eastmoney_direct → sina → ths
Real-timeeastmoney_direct → eastmoney → xueqiu → ths (the last two are skipped when no symbol is given)
Newseastmoney → ths
Financial statementssina ⇄ 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.

Market Data Tools

get_hist_data

Get historical stock market data with support for multiple time periods and adjustment methods.

Parameters
  • symbol (string, required): Stock code (e.g. '000001')
  • interval (string, optional): Time interval ('minute','hour','day','week','month','year') (default: 'day')
  • interval_multiplier (number, optional): Interval multiplier (default: 1)
  • start_date (string, optional): Start date in YYYY-MM-DD format (default: '1970-01-01')
  • end_date (string, optional): End date in YYYY-MM-DD format (default: '2030-12-31')
  • adjust (string, optional): Adjustment type ('none', 'qfq', 'hfq') (default: 'none')
  • source (string, optional): Data source ('eastmoney', 'eastmoney_direct', 'sina', 'ths') (default: 'eastmoney')
  • fallback (boolean, optional): Try 'eastmoney', 'eastmoney_direct', 'sina' and 'ths' in order when the chosen source fails or has no data (default: true)
  • indicators_list (list, optional): Technical indicators to add
  • recent_n (number, optional): Number of most recent records to return (default: 100)
get_realtime_data

Get real-time stock market data.

Parameters
  • symbol (string, optional): Stock code
  • source (string, optional): Data source ('eastmoney_direct', 'eastmoney', 'xueqiu', 'ths') (default: 'eastmoney_direct')
  • 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)

News & Information Tools

get_news_data

Get stock-related news data.

Parameters
  • symbol (string, required): Stock code
  • source (string, optional): Data source ('eastmoney', 'ths') (default: 'eastmoney')
  • fallback (boolean, optional): Try 'eastmoney' and 'ths' in order when the chosen source fails or has no data (default: true)
  • recent_n (number, optional): Number of most recent records to return, newest first (default: 10)

Financial Statement Tools

get_balance_sheet

Get company balance sheet data.

Parameters
  • symbol (string, required): Stock code
  • source (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'sina')
  • fallback (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
  • recent_n (number, optional): Number of most recent records to return (default: 10)
get_income_statement

Get company income statement data.

Parameters
  • symbol (string, required): Stock code
  • source (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'sina')
  • fallback (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
  • recent_n (number, optional): Number of most recent records to return (default: 10)
get_cash_flow

Get company cash flow statement data.

Parameters
  • symbol (string, required): Stock code
  • source (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'sina')
  • fallback (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
  • recent_n (number, optional): Number of most recent records to return (default: 10)

Analysis & Metrics Tools

get_inner_trade_data

Get company insider trading data.

Parameters
  • symbol (string, required): Stock code
get_financial_metrics

Get key financial metrics from the three major financial statements.

Parameters
  • symbol (string, required): Stock code
  • source (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'eastmoney_direct')
  • fallback (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
  • recent_n (number, optional): Number of most recent records to return (default: 10)
get_time_info

Get current time with ISO format, timestamp, and the last trading day.

Installation & Setup

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:

bash
npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude
Option 2: Via uv

Install uv if you haven't already.

uvx installs the package from PyPI and runs it on Python 3.12 or newer.

Add the following configuration to your MCP Client settings:

json
{  "mcpServers": {    "akshare-one-mcp": {      "command": "uvx",      "args": ["akshare-one-mcp"]    }  }}
Option 3: Local Development Setup

  1. Clone this repository:

    bash
    git clone https://github.com/zwldarren/akshare-one-mcp.gitcd akshare-one-mcp

  2. Install dependencies:

    bash
    uv sync

  3. Add the following configuration to your MCP Client settings:

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

Technical Indicators Reference

The get_hist_data tool supports the following technical indicators:

Trend Indicators

  • Moving Averages: SMA (Simple Moving Average), EMA (Exponential Moving Average)
  • Trend Tracking: MACD (Moving Average Convergence Divergence), APO (Absolute Price Oscillator), PPO (Percentage Price Oscillator)
  • Rate of Change: ROC (Rate of Change), ROCP (Rate of Change Percentage), ROCR (Rate of Change Ratio), ROCR100
  • Other: TRIX (Triple Exponential Moving Average), ULTOSC (Ultimate Oscillator)

Momentum Indicators

  • Relative Strength: RSI (Relative Strength Index), CCI (Commodity Channel Index)
  • Trend Strength: ADX (Average Directional Index), DX (Directional Index)
  • Money Flow: MFI (Money Flow Index), MOM (Momentum), CMO (Chande Momentum Oscillator), WILLR (Williams %R)

Volatility Indicators

  • Bollinger Bands: BOLL (Bollinger Bands)
  • Average True Range: ATR (Average True Range)
  • Parabolic SAR: SAR (Parabolic Stop and Reverse)

Volume Indicators

  • Volume: OBV (On-Balance Volume), AD (Accumulation/Distribution Line), ADOSC (Accumulation/Distribution Oscillator)

Other Indicators

  • Stochastic: STOCH (Stochastic Oscillator)
  • Aroon: AROON (Aroon Indicator), AROONOSC (Aroon Oscillator)
  • Balance of Power: BOP (Balance of Power)
  • Directional Indicators: MINUS_DI, MINUS_DM, PLUS_DI, PLUS_DM
  • Time Series Forecast: TSF (Time Series Forecast)

來源：README.md，提交 793124d

工具

0
SourceWeft 曾在隔離沙箱中以無憑證方式啟動該軟體包一次，以列出其工具，但未能完成：軟體包安裝失敗。

版本歷史

4
  1. v0.5.0最新Oct 23, 2026
  2. v0.4.1Oct 18, 2026
  3. v0.4.0Sep 19, 2026
  4. v0.3.6Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分