让 Claude Code / Codex / Cursor / 任意 **AI Agent（MCP）**直接调用 A 股数据：行情 / K线 / 五档盘口 / 财务 / 资金 / 龙虎榜 / 板块 / 可转债 / 因子选股 / 宏观 / 量化回测 —— 31 个工具，免费工具无需 Key。
中文 · English
支持 19 家主流 AI Agent 客户端 —— 开箱即用：
官网 · 文档 · 端点清单 · MCP 接入 · Agent Skill
GitHub 源码 · 问题反馈 Issues · 更新日志
一个 A股数据 MCP：把 A 股数据封装成 AI Agent 能直接调用的工具。配一次，之后你问「某某股票今天资金怎么样」，Agent 自己会去调对应工具拿真实数据 —— 不用你写代码，也不用每次把用法贴给它。
Related MCP server: Stock MCP
31 个工具，一次配好：行情 / 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，URLhttps://api.ashareapi.com/mcp。免费工具不用 Key；要用付费工具再加请求头Authorization: Bearer ct-你的KEY。加完确认能连上、能看到 31 个工具。
加完重启客户端（或重开会话）配置才生效 —— 重启后直接在对话里问，例如「查一下某某股票今天的资金」。
配置文件位置（键名与文件名都逐家核对过官方文档）：
客户端 | 配置文件 |
Claude Code |
|
Cursor |
|
VS Code |
|
Codex |
|
OpenCode |
|
Gemini CLI |
|
Cline |
|
Windsurf |
|
CodeBuddy |
|
WorkBuddy |
|
Trae | 设置 → MCP → 手动配置 |
Kimi Code |
|
ZCode |
|
MiMo Code |
|
Kilo Code |
|
Manus | 设置 → 集成 → 自定义 MCP |
Devin |
|
OpenClaw |
|
Hermes |
|
国内平台（同样填 URL + 请求头，无需安装任何东西）：阿里云百炼 · 扣子 Coze · 腾讯元器 · 腾讯云智能体开发平台 · 火山方舟
各家完整配置写法（键名不一样，别照抄）：https://ashareapi.com/mcp
pip install -r requirements.txt{
"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 会自动调用下面的工具拿真实数据（不是编造）。
变量 | 默认 | 说明 |
|
| 服务端地址（一般不用改） |
| 空 | API Key。留空也能用 5 个免费工具；付费工具必填（获取，¥9.9 起） |
python mcp_ashare.py --selftest # 直连 REST 验证工具可用性（不启 MCP）工具 | 说明 | 免 Key |
| 实时行情快照（现价/开高低/量额/换手率） | ✅ |
| K 线（日/周/月/季/年 + 分钟线 | ✅ 日线及以上 / 分钟线付费 |
| 分时（当日 / 近 5 日盘中走势） | — |
| 全历史 K 线（10 年日线，2016-08-08 起）· 复权可选 | — |
| 量化回测（单标的实时 / 组合预计算）· 收益 / 回撤 / 交易次数 / 净值曲线 | — |
| 批量回测（多标的 × 多策略对比矩阵，≤20×≤10） | — |
| 量化策略清单（20 条单标的 + 9 条组合，含参数范围） | — |
| 量化因子库（88 因子 + 50 筛选入口 + 22 预设） | — |
| 量化方法论库（13 条「怎么判断市场」流程） | — |
| 热搜榜 | ✅ |
| 市场总览（画像/估值/风格轮动） | ✅ |
| 涨跌分布（市场广度） | ✅ |
| 五档盘口（买五卖五 + 挂单量） | — |
| 全字段行情画像（估值/市值/股本/涨停价） | — |
| 财务报表（利润表 / 资产负债表 / 现金流量表） | — |
| 个股资金 + 龙虎榜 + 大宗 + 两融（一接口拿全） | — |
| 龙虎榜分榜（机构 / 游资 / 活跃席位） | — |
| 技术指标 MA / MACD / KDJ / RSI / BOLL | — |
| 股东研究（十大股东 / 股东户数 / 机构持仓） | — |
| 个股事件标签（42 类） | — |
| 因子选股（多因子交集 / 22 个预设） | — |
| 板块行情榜（行业 / 概念 / 地域） | — |
| 板块估值（含历史百分位） | — |
| 宏观数据（GDP / CPI / PMI / LPR / 国债收益率） | — |
| 可转债条款（溢价率 / 双低 / 强赎触发价） | — |
| ETF 行情 / 规模 / 溢折率 / 资金流 | — |
| 新股日历（发行 / 申购 / 中签 / 上市） | — |
| 分红送转历史 | — |
| 脱水研报（券商研报摘要） | — |
| 股票 / 基金 / 板块搜索（模糊词消歧） | — |
| 查询自己的用量与额度 | — |
⚠️ K 线复权口径由服务端固定（没有
adjust参数）：日线及以上为前复权（除权除息日不跳空），分钟线为不复权 —— 不要再自己复权（会二次复权）。⚠️
ashare_minute（分时）≠ashare_kline的分钟线：前者是每分钟一个价+累计量，后者是 OHLC 蜡烛。💡 计费 = 次数：
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
MIT · 数据仅供研究参考，不构成投资建议
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
China A-share data for AI agents: 57 read-only tools plus 6 tools for your own watchlist.
China A-share market data over MCP: 22 tools for quotes, K-line, financials, money flow, top-trader boards, sectors, macro, convertible bonds and factor screening. Five tools need no API key, so you can connect and try it immediately.
China A-share screening, filings, holdings, flows and calendars as agent tools.
Provide access to Chinese stock market data including historical prices, real-time data, news, and…
