AKShare One MCP Server

AKShare One MCP 服务

概述

这是一个基于 akshare-one 的 MCP 服务，提供全面的中国股票市场数据接口。它提供一组强大的工具，用于获取金融信息，包括历史股票数据、实时数据、新闻数据和财务报表。

可用工具

自动切换数据源

除上游仅提供单一数据源的 get_inner_trade_data 外，每个数据工具都有一个用于指定首选数据源的 source 参数，以及一个默认开启的 fallback 参数，用于决定当该数据源抛出异常或返回空数据框时，是否尝试同一领域的其他数据源：

领域	尝试顺序
历史数据	eastmoney → eastmoney_direct → sina → ths
实时数据	eastmoney_direct → eastmoney → xueqiu → ths（未提供代码时会跳过最后两个数据源）
新闻	eastmoney → ths
财务报表	sina ⇄ eastmoney_direct

始终首先尝试请求的 source；只有回退时才遵循上述顺序。由于 akshare-one 会将每个数据源的输出映射到其所属领域声明的列，因此切换数据源不会改变字段名称或顺序。如果所有数据源都失败，错误信息会列出每个数据源及其失败原因；如果所有数据源都成功但没有数据，则返回空结果。将 fallback 设为 false 可固定使用单一数据源——此时发生故障会直接显示错误，这在需要准确了解数据来源时很有用。

实际处理调用的数据源会记录在 akshare_one_mcp.providers 日志记录器中。

市场数据工具

get_hist_data

获取历史股票市场数据，支持多个时间周期和复权方式。

参数

• symbol（字符串，必填）：股票代码（例如：'000001'）
• interval（字符串，可选）：时间周期（'minute'、'hour'、'day'、'week'、'month'、'year'）（默认值：'day'）
• interval_multiplier（数字，可选）：周期倍数（默认值：1）
• start_date（字符串，可选）：开始日期，格式为 YYYY-MM-DD（默认值：'1970-01-01'）
• end_date（字符串，可选）：结束日期，格式为 YYYY-MM-DD（默认值：'2030-12-31'）
• adjust（字符串，可选）：复权类型（'none'、'qfq'、'hfq'）（默认值：'none'）
• source（字符串，可选）：数据源（'eastmoney'、'eastmoney_direct'、'sina'、'ths'）（默认值：'eastmoney'）
• fallback（布尔值，可选）：所选数据源失败或没有数据时，按顺序尝试 'eastmoney'、'eastmoney_direct'、'sina' 和 'ths'（默认值：true）
• indicators_list（列表，可选）：要添加的技术指标
• recent_n（数字，可选）：返回最近的记录数量（默认值：100）

#### `get_realtime_data` 获取实时股市数据。

参数

• symbol（string，可选）：股票代码
• source（string，可选）：数据源（'eastmoney_direct'、'eastmoney'、'xueqiu'、'ths'）（默认值：'eastmoney_direct'）
• fallback（boolean，可选）：所选数据源失败或无数据时，依次尝试 'eastmoney_direct'、'eastmoney'、'xueqiu' 和 'ths'（默认值：true；未提供代码时会跳过 'xueqiu' 和 'ths'，因为它们一次只提供一个代码的报价）

新闻与资讯工具

get_news_data

获取与股票相关的新闻数据。

参数

• symbol（string，必填）：股票代码
• source（string，可选）：数据源（'eastmoney'、'ths'）（默认值：'eastmoney'）
• fallback（boolean，可选）：所选数据源失败或无数据时，依次尝试 'eastmoney' 和 'ths'（默认值：true）
• recent_n（number，可选）：返回最近记录的数量，按时间从新到旧排序（默认值：10）

财务报表工具

get_balance_sheet

获取公司资产负债表数据。

参数

• symbol（string，必填）：股票代码
• source（string，可选）：数据源（'sina'、'eastmoney_direct'）（默认值：'sina'）
• fallback（boolean，可选）：所选数据源失败或无数据时，尝试另一个数据源（默认值：true）
• recent_n（number，可选）：返回最近记录的数量（默认值：10）

get_income_statement

获取公司利润表数据。

参数

• symbol（string，必填）：股票代码
• source（string，可选）：数据源（'sina'、'eastmoney_direct'）（默认值：'sina'）
• fallback（boolean，可选）：所选数据源失败或无数据时，尝试另一个数据源（默认值：true）
• recent_n（number，可选）：返回最近记录的数量（默认值：10）

get_cash_flow

获取公司现金流量表数据。

参数

• symbol（string，必填）：股票代码
• source（string，可选）：数据源（'sina'、'eastmoney_direct'）（默认值：'sina'）
• fallback（boolean，可选）：所选数据源失败或无数据时，尝试另一个数据源（默认值：true）
• recent_n（number，可选）：返回最近记录的数量（默认值：10）

分析与指标工具

get_inner_trade_data

获取公司内部人士交易数据。

参数

• symbol（string，必填）：股票代码

get_financial_metrics

从三大财务报表中获取关键财务指标。

参数

• symbol（string，必填）：股票代码
• source（string，可选）：数据源（'sina'、'eastmoney_direct'）（默认值：'eastmoney_direct'）
• fallback（boolean，可选）：所选数据源失败或无数据时，尝试另一个数据源（默认值：true）
• recent_n（number，可选）：返回最近记录的数量（默认值：10）

get_time_info

获取当前时间的 ISO 格式、时间戳以及最近的交易日。

安装与设置

运行模式

服务支持两种模式：stdio 和 streamable-http

命令行参数：

• --streamable-http：启用 HTTP 模式（默认：stdio 模式）
• --host：HTTP 模式下绑定的主机（默认：0.0.0.0）
• --port：HTTP 模式下监听的端口（默认：8081）

注意： 使用 streamable-http 模式时，MCP 服务可通过 http://{host}:{port}/mcp 访问。对于默认配置，地址为 http://0.0.0.0:8081/mcp。

安装选项

选项 1：通过 Smithery

通过 Smithery 自动为 Claude Desktop 安装 akshare-one-mcp：

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

选项 2：通过 uv

如果尚未安装，请安装 uv。

uvx 会从 PyPI 安装软件包，并在 Python 3.12 或更高版本上运行。

将以下配置添加到 MCP 客户端设置中：

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

选项 3：本地开发环境设置

1. 克隆此仓库：

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

2. 安装依赖项：

   uv sync
   

3. 将以下配置添加到 MCP 客户端设置中：

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

技术指标参考

get_hist_data 工具支持以下技术指标：

趋势指标

• 移动平均线：SMA（简单移动平均线）、EMA（指数移动平均线）
• 趋势跟踪：MACD（指数平滑异同移动平均线）、APO（绝对价格振荡器）、PPO（百分比价格振荡器）
• 变化率：ROC（变化率）、ROCP（变化率百分比）、ROCR（变化率比值）、ROCR100
• 其他：TRIX（三重指数移动平均线）、ULTOSC（终极振荡器）

动量指标

• 相对强度：RSI（相对强弱指标）、CCI（商品通道指数）
• 趋势强度：ADX（平均趋向指数）、DX（趋向指数）
• 资金流：MFI（资金流量指标）、MOM（动量）、CMO（钱德动量振荡器）、WILLR（威廉指标 %R）

波动率指标

• 布林带：BOLL（布林带）
• 平均真实波幅：ATR（平均真实波幅）
• 抛物线 SAR：SAR（抛物线止损和反转）

成交量指标

• 成交量：OBV（能量潮）、AD（累积／派发线）、ADOSC（累积／派发振荡器）

其他指标

• 随机指标：STOCH（随机振荡器）
• Aroon 指标：AROON（Aroon 指标）、AROONOSC（Aroon 振荡器）
• 多空力量均衡指标：BOP（多空力量均衡指标）
• 趋向指标：MINUS_DI、MINUS_DM、PLUS_DI、PLUS_DM
• 时间序列预测：TSF（时间序列预测）