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 分