ashareapi — A股数据 API 官方 MCP 服务器

让 Claude Code / Codex / Cursor / 任意 **AI Agent（MCP）**直接调用 A 股数据：行情 / K线 / 五档盘口 / 财务 / 资金 / 龙虎榜 / 板块 / 可转债 / 因子选股 / 宏观 —— 24 个工具，免费工具无需 Key。

中文 · English

支持 19 家主流 AI Agent 客户端 —— 开箱即用：

官网 · 文档 · 端点清单 · MCP 接入 · Agent Skill

GitHub 源码 · 问题反馈 Issues · 更新日志

这是什么

一个 A股数据 MCP：把 A 股数据封装成 AI Agent 能直接调用的工具。配一次，之后你问「某某股票今天资金怎么样」，Agent 自己会去调对应工具拿真实数据 —— 不用你写代码，也不用每次把用法贴给它。

Related MCP server: go-stock-mcp

为什么用它

• 24 个工具，一次配好：行情 / K线 / 五档盘口 / 全字段画像 / 财务 / 资金 / 龙虎榜 / 板块 / 宏观 / 可转债 / ETF / 因子选股 —— 覆盖 A 股主流面

• 免费工具真的免 Key：ashare_quote / ashare_kline / ashare_hot / ashare_market_overview / ashare_changedist 装上就能调，不用先买 Key

• 托管端点零安装：填一个 URL 就能用；也可以本地 stdio 自托管（内网 / 想读源码）

• 多源自动切换：后端 70 个数据源互为备份，某个源出问题会自动换下一个，且不扣调用次数

• 工具描述写给 AI 看：每个工具都写清「什么时候用 / 参数怎么填 / 返回什么」，Agent 不会调错

• 无数据 ≠ 失败：停牌这类「市场真没数据」和「取数失败」分开返回 —— Agent 不会把停牌误判成故障

• 口径固定，不用二次处理：K 线固定前复权（没有 adjust 参数），不会二次复权

• 不用你维护：多源切换 / 缓存 / 巡检都在服务端，客户端只负责调用

两种用法

⚠️ 托管端点填 https://api.ashareapi.com/mcp —— 站点上的 ashareapi.com/mcp 是配置说明页，不是接口地址。

托管端点最快的接法 —— Claude Code 一行命令（其他客户端见下节）：

# 免费工具（无需 Key）
claude mcp add --transport http ashareapi https://api.ashareapi.com/mcp

# 要用付费工具（财务 / 资金 / 龙虎榜…）再加请求头
claude mcp add --transport http ashareapi https://api.ashareapi.com/mcp \
  --header "Authorization: Bearer ct-你的KEY"

claude mcp list   # 验证：应显示 √ Connected（不显示工具数，工具在会话里让它列）

或者交给你的 AI Agent —— 复制这句话发给它：

帮我把这个 ashareapi MCP 服务器加上：名字 ashareapi，类型 HTTP，URL https://api.ashareapi.com/mcp。免费工具不用 Key；要用付费工具再加请求头 Authorization: Bearer ct-你的KEY。加完确认能连上、能看到 24 个工具。

加完重启客户端（或重开会话）配置才生效 —— 重启后直接在对话里问，例如「查一下某某股票今天的资金」。

支持的客户端

配置文件位置（键名与文件名都逐家核对过官方文档）：

国内平台（同样填 URL + 请求头，无需安装任何东西）：阿里云百炼 · 扣子 Coze · 腾讯元器 · 腾讯云智能体开发平台 · 火山方舟

各家完整配置写法（键名不一样，别照抄）：https://ashareapi.com/mcp

本地运行

环境要求

• Python ≥ 3.9

• 依赖：mcp（1.x 与 2.x 都支持）+ requests（≥ 2.28）

pip install -r requirements.txt

配置（以 Claude Desktop 为例）

{
  "mcpServers": {
    "ashareapi": {
      "command": "python",
      "args": ["/path/to/mcp_ashare.py"],
      "env": {
        "ASHARE_API": "https://api.ashareapi.com",
        "ASHARE_KEY": "ct-xxxxxxxx"
      }
    }
  }
}

配置好之后可以直接说：

查一下 600667 现在多少钱
帮我筛一下 PE<20 且 ROE>15 的股票
今天市场什么情况

→ AI 会自动调用下面的工具拿真实数据（不是编造）。

环境变量

自测

python mcp_ashare.py --selftest     # 直连 REST 验证工具可用性（不启 MCP）

24 个工具

⚠️ K 线价格口径固定为前复权（除权除息日不跳空；没有 adjust 参数）—— 不要再自己复权（会二次复权）。

💡 计费 = 次数：ashare_snapshot 一次拿全估值+市值+股本+涨停价，比分别调 quote / valuation / orderbook 更省次数。

开发 / 测试

pip install -r requirements.txt
pip install pytest
pytest -q

测试会以**真实 MCP 协议（stdio）**起一次服务端并取工具清单（不发起任何网络请求）。

相关

官方 SDK：Python pip install ashareapi · Node.js / TypeScript npm install ashareapi

Agent Skill（给 AI 读的接口说明书）：https://ashareapi.com/skill

License

MIT · 数据仅供研究参考，不构成投资建议