AHShare MCP Server

<div align="center">

纯 TypeScript 实现的中国 A 股市场数据 MCP 服务器

</div>

---

概述

ahshare-mcp 是一个基于 Model Context Protocol (MCP) 的服务器，为 AI 助手（如 Claude Desktop、VS Code Copilot）提供中国 A 股市场金融数据访问能力。

核心特点：与 Python 版 akshare-one-mcp 功能兼容，但使用 纯 TypeScript 实现，零 Python 依赖。

与 Python 版的区别

维度	Python 版	TypeScript 版
语言	Python 3.12+	TypeScript 5.x
运行时	CPython	Node.js 22+
数据源	通过 akshare-one 库	直接调用 HTTP API
Python 依赖	❌ 必需	✅ 零依赖
技术指标	pandas 计算	纯 TS 数学实现
部署	Python + pip/uv	单 Node.js 进程
镜像大小	~500MB	~150MB
MCP 工具数	9	12（含股东/基金持股）

---

功能特性

📊 市场数据（3 个工具）

• 历史 K 线 — 日/周/月/分钟级，支持前/后复权，多数据源
• 实时行情 — 最新价、涨跌幅、市值、PE/PB
• 34 种技术指标 — SMA/EMA/MACD/RSI/BOLL/ATR/CCI/ADX/MFI 等

💰 财务报表（4 个工具）

• 资产负债表 — 总资产、固定资产、货币资金、存货、负债
• 利润表 — 营业收入、营业成本、营业利润、净利润
• 现金流量表 — 经营/投资/筹资现金流
• 财务指标 — 三表合并关键指标

👥 股东数据（3 个工具）

• 十大股东 — 排名、持股数、持股比例、变动详情
• 十大流通股东 — 类型分类（基金/QFII/券商/保险）
• 基金持股 — 全量（不限于前10），1000+ 条记录

📰 其他（2 个工具）

• 个股新闻 — 东方财富新闻搜索
• 内部交易 — 董监高增/减持记录
• 时间信息 — 当前时间 + 最近交易日

---

安装

前提条件

• Node.js >= 22
• （可选）Bun 用于开发

通过 npm 安装

npm install -g ahshare-mcp

从源码安装

git clone https://github.com/terrysun1216/ahshare-mcp-ts.git
cd ahshare-mcp-ts
npm install
npm run build

---

使用

Claude Desktop 集成

在 Claude Desktop 配置文件中添加：

{
  "mcpServers": {
    "ahshare-mcp": {
      "command": "npx",
      "args": ["ahshare-mcp"]
    }
  }
}

或在 VS Code Copilot 中：

{
  "mcpServers": {
    "ahshare-mcp": {
      "command": "npx",
      "args": ["tsx", "/path/to/ahshare-mcp-ts/src/main.ts"]
    }
  }
}

命令行

# stdio 模式（默认，供 MCP 客户端使用）
ahshare-mcp

# HTTP 模式（供远程/Web 客户端使用）
ahshare-mcp --streamable-http --port 8081

示例对话

配置后，在 Claude 中可以这样对话：

"帮我查看贵州茅台 600519 最近 30 天的日线走势和 MACD 指标"

"贵州茅台最新的十大股东是谁？持股市值多少？"

"对比一下 600519 和 000858 的 PE、ROE 等财务指标"

"有哪些基金重仓持有了贵州茅台？"

---

MCP 工具列表

#	工具名	描述	数据源
1	get_time_info	当前时间、时间戳、最近交易日	新浪
2	get_hist_data	历史 K 线数据 + 34种技术指标	东方财富/新浪
3	get_realtime_data	实时行情（价格/涨跌/市值/PE/PB）	东方财富
4	get_news_data	个股新闻	东方财富
5	get_balance_sheet	资产负债表	东方财富
6	get_income_statement	利润表	东方财富
7	get_cash_flow	现金流量表	东方财富
8	get_financial_metrics	三大报表合并关键指标	东方财富
9	get_inner_trade_data	董监高内部交易	雪球
10	get_top10_shareholders	十大股东 + 十大流通股东	东方财富 F10
11	get_top10_free_shareholders	十大流通股东明细	东方财富 F10
12	get_fund_holdings	基金持股明细（全量）	新浪财经

34 种技术指标

类别	指标
趋势	SMA, EMA, MACD, APO, PPO, TRIX, ULTOSC
动量	RSI, CCI, ADX, DX, MFI, MOM, CMO, WILLR
波动率	BOLL, ATR, SAR
成交量	OBV, AD, ADOSC
方向	PLUS_DI, PLUS_DM, MINUS_DI, MINUS_DM
变化率	ROC, ROCP, ROCR, ROCR100
其他	AROON, AROONOSC, BOP, STOCH, TSF

---

架构

                  ┌─────────────────────────┐
                  │    MCP Client            │
                  │  (Claude Desktop / VS Code) │
                  └──────┬──────────────────┘
                         │ JSON-RPC (stdio / HTTP)
                  ┌──────┴──────────────────┐
                  │    MCP Server Layer      │
                  │  @modelcontextprotocol/   │
                  │  sdk + Hono + Zod        │
                  ├──────────────────────────┤
                  │    Service Layer         │
                  │  行情 / 财务 / 股东 / 新闻  │
                  ├──────────────────────────┤
       ┌──────────┼──────────┬──────────────┤
       │          │          │              │
  ┌────┴───┐ ┌───┴────┐ ┌───┴───┐ ┌───────┴──┐
  │东方财富 │ │ 新浪   │ │ 雪球  │ │ 指标引擎 │
  │ HTTP   │ │ HTTP   │ │ HTTP  │ │ 34 函数  │
  └────────┘ └────────┘ └───────┘ └──────────┘

数据流向：MCP Client → JSON-RPC → MCP Server → Service → HTTP Provider → 东方财富/新浪/雪球公开 API

零 Python 依赖：直接从 TypeScript 调用各数据源的公开 HTTP 接口，使用 Node.js 内置 fetch API。

---

技术栈

包	版本	用途
@modelcontextprotocol/sdk	^1.29	MCP 协议实现
hono	^4.12	HTTP 框架
zod	^4.4	参数校验 + 类型推导
typescript	^5.9	类型系统
vitest	^4.1	测试框架

仅 3 个生产依赖，与 Lyna 项目使用完全相同的技术栈。

---

开发

# 安装依赖
npm install

# 开发运行（stdio 模式）
npm run dev

# 开发运行（HTTP 模式）
npm run dev:http

# 运行测试
npm test

# 编译
npm run build

项目结构

src/
├── main.ts              # CLI 入口
├── config.ts            # 全局配置
├── calendar.ts          # 交易日历
├── server/              # MCP Server (stdio + HTTP)
├── tools/               # 12 个 MCP 工具定义
├── services/            # 业务逻辑层
├── providers/           # HTTP API 层（东方财富/新浪/雪球/F10）
├── indicators/          # 34 个技术指标纯函数
└── types/               # Zod Schema + TS 类型

测试

全部 13 个 E2E 测试通过，使用真实数据验证：

npm test                    # 单元测试
npx tsx tests/e2e-all-tools.test.ts  # 端到端测试

---

许可证

MIT © Terry

---

致谢

• AKShare — 底层数据源研究和参考
• akshare-one-mcp — Python 版 MCP 参考实现
• Lyna — TypeScript MCP 架构参考