Stock MCP Server

快速开始

在 claude_desktop_config.json 中添加以下配置：

// claude_desktop_config.json { "mcpServers": { "stock": { "url": , "headers": { "Authorization": "Bearer sk-stock-mcp-secret-key-2024" } } } }

部署后将地址替换为实际域名，并将 Authorization 替换为你的实际 API Key。

工具详情与参数

get_quote

批量获取股票实时行情快照，返回价格/涨跌幅/成交量/PE/PB/52周高低/股息率等完整字段。支持A股（含沪/深/北交所）、港股、美股、指数。

参数	类型	默认值	说明
codes	`string`	—	逗号分隔的股票代码。格式: A股带后缀 .SH/.SZ/.BJ（如600519.SH），港股带 .HK（如00700.HK），美股直接代码（如AAPL），指数直接代码（如DJI/NDX/HSI）

      /** 返回字段 */

      price/close: 最新价（元），港股为港元，美股为美元

      change: 涨跌额   pct_change: 涨跌幅（%）

      volume: 成交量（手），A股为万手（自动转换）   amount: 成交额（亿元）

      turnover: 换手率（%），仅A股有数据

      pe: 市盈率TTM（倍），亏损或无数据时为null

      pb: 市净率（倍）   dividend_yield: 股息率（小数），无分红时为null

      week52High/week52Low: 52周最高/最低价（元）   open: 今日开盘价

      pre_close: 昨日收盘价   price_timestamp: 数据发布时间

get_kline

获取日/周/月K线历史数据，支持A股/港股/美股。分钟K线需用 get_minute_kline 接口。

参数	类型	默认值	说明
code	`string`	—	股票代码，格式同 get_quote
period	`string`	day	K线周期: day(日K) / week(周K) / month(月K)。分钟K线请用 get_minute_kline
num	`number`	100	数据条数上限（默认100条，最新日期排在最后）
adjust	`string`	qfq	复权类型（暂未生效，等效前复权）

      /** 返回字段 */

      date: K线日期，日K为交易日，周/月K为周期末日期

      open/high/low/close: 开/高/低/收盘价（元）

      volume: 成交量（手）   amount: 成交额（A股为万元）

      change: 涨跌额（元），仅日K   pct_change: 涨跌幅（%），仅日K

      /** 调用示例 */

      code="600519.SH", period="day", num=30（最近30个交易日）

      code="00700.HK", period="week", num=52（最近52周）

get_realtime_minute

获取A股当日1分钟K线明细（非原始逐笔成交）。每根K线包含每分钟的开盘/收盘/最高/最低价，描绘当日分时走势。

参数	类型	默认值	说明
code	`string`	—	A股股票代码，如 600519.SH。仅支持A股

      /** 数据范围 */

      返回当日全量1分钟K线，最多240条（A股每日4小时交易时间）

      只能在交易日调用，非交易时间返回空数组

      /** 返回字段 */

      timestamp: 时间戳（毫秒）   date: 交易日期   time: 交易时间

      open/high/low/close: 开/高/低/收盘价（元）   volume: 该分钟成交量（手）

get_minute_kline

获取5/15/30/60分钟K线，适用于A股和港股。返回OHLC格式历史K线，可用于短期趋势分析和择时。

参数	类型	默认值	说明
code	`string`	—	股票代码，格式同 get_quote。支持A股和港股
scale	`number`	5	分钟周期，仅支持: 5 / 15 / 30 / 60
num	`number`	20	数据条数上限（默认20条，最新日期排在最后）

      /** scale 说明 */

      5: 5分钟K线，最适合日内T+0择时

      15: 15分钟K线，适合短期波段操作

      30/60: 30/60分钟K线（日内趋势延续判断）

      /** 调用示例 */

      code="000001.SZ", scale=5, num=100（最近100根5分钟K线）

      code="00700.HK", scale=15, num=50（最近50根15分钟K线）

get_stock_info

简化版实时行情，适合列表展示和批量查询。数值已做预处理（取整、单位转换），拿来直接显示无需额外处理。

参数	类型	默认值	说明
codes	`string`	—	逗号分隔的股票代码，格式同 get_quote

      /** 与 get_quote 的区别 */

      get_quote: 返回完整字段（PE/PB/52周高低等），数值未取整，适合程序二次处理

      get_stock_info: 数值已四舍五入，成交量转万手，成交额转亿元，适合直接展示

      /** 返回字段 */

      code/name/price/change/pct_change: 代码/名称/最新价/涨跌额/涨跌幅（%）

      volume: 成交量（万手）   amount: 成交额（亿元）

      open/high/low: 今日开/最高/最低价（元）   pre_close: 昨日收盘价

search_stocks

按股票名称或代码关键字搜索匹配股票，返回结果列表包含代码/名称/类型/交易所。

参数	类型	默认值	说明
keyword	`string`	—	搜索关键词（股票名称或代码），必填

      /** 搜索规则 */

      支持按名称搜索（如"茅台"返回所有名称含茅台的股票）

      支持按代码搜索（如"600519"精确定位）

      返回结果按相关度排序

      /** 返回字段 */

      code: 股票代码（带后缀）   name: 股票名称

      type: 股票类型（A股、港股、美股等）

      market: 交易所（上交所.SH、深交所.SZ、港交所.HK、纳斯达克.NASDAQ等）

get_indices

获取全球主要指数实时行情，当前包含以下四个指数：道琼斯工业平均指数 (DJI)、纳斯达克100指数 (NDX)、恒生指数 (HSI)、恒生科技指数 (HSTECH)。

参数	类型	默认值	说明
无参数，直接调用即可获取全部四个指数的实时行情

      /** 返回字段 */

      code/name/price: 指数代码/名称/当前点位

      change: 涨跌点数   pct_change: 涨跌幅（%）

      volume: 成交量（手）   amount: 成交额（亿元）

      high/low: 今日最高/最低点位   open/pre_close: 今日开盘/昨日收盘点位

get_tech_kdj

KDJ随机指标，通过比较收盘价与n日内最低价、最高价的范围来判断价格动量。适合短线交易参考。

参数	类型	默认值	说明
code	`string`	—	股票代码，格式同 get_quote
period	`string`	day	K线周期: day / week / month
num	`number`	9	RSV计算周期（默认9）

      /** 计算公式 */

      RSV(n) = (收盘价 - n日最低价) / (n日最高价 - n日最低价) × 100

      K = 上一日K值 × (1-2/3) + RSV × 2/3   D = 上一日D值 × (1-2/3) + K × 2/3

      J = 3×K - 2×D

      /** 研判标准 */

      K/D值80以上为超买区（可能回调），20以下为超卖区（可能反弹）

      K上穿D（金叉）+ J超卖→买入信号   K下穿D（死叉）+ J超买→卖出信号

      J值>100或<-20为极端信号

get_tech_macd

MACD指数平滑异同移动平均线，是最常用的趋势判断指标之一，适合中线趋势跟踪。

参数	类型	默认值	说明
code	`string`	—	股票代码，格式同 get_quote
period	`string`	day	K线周期: day / week / month
fast	`number`	12	快线EMA周期（默认12）
slow	`number`	26	慢线EMA周期（默认26）
signal	`number`	9	信号线SMA周期（默认9）

      /** 计算公式 */

      DIF = 12日EMA - 26日EMA（快线）

      DEA = DIF的9日SMA（慢线/信号线）

      MACD柱 = (DIF - DEA) × 2

      /** 研判标准 */

      DIF>0 + MACD柱向上扩大切换→多头信号（买入）

      DIF上穿DEA（金叉）+ MACD柱由负转正→买入信号

      DIF下穿DEA（死叉）+ MACD柱由正转负→卖出信号

      背离：价格创新低但MACD未创新低→底背离（见底信号）

get_tech_boll

BOLL布林带，由中轨（MA20）和上下轨（±2倍标准差）组成。用于判断价格波动区间和趋势收敛发散。

参数	类型	默认值	说明
code	`string`	—	股票代码，格式同 get_quote
period	`string`	day	K线周期: day / week / month
boll_period	`number`	20	中轨MA周期（默认20）
std_dev	`number`	2.0	标准差倍数（默认2倍）

      /** 计算公式 */

      中轨 = n日简单移动平均线（SMA）

      上轨 = 中轨 + 2 × n日标准差   下轨 = 中轨 - 2 × n日标准差

      布林带张口：上下轨间距扩大（波动加剧）

      布林带收口：上下轨间距收窄（波动趋缓，可能酝酿突破）

      /** 研判标准 */

      价格触及上轨+放量→可能上涨延续

      价格触及下轨+缩量→可能反弹信号

      布林带持续收口→酝酿突破（张口后顺势操作）

get_financial_summary

获取A股主要财务指标概览，涵盖盈利能力、每股指标、资产负债和重要比率，支持多报告期（年报+季报）返回。

参数	类型	默认值	说明
code	`string`	—	A股股票代码，如 600519.SH
num	`number`	4	返回报告期数量（默认4，最大12）

      /** 单位: 亿元，比率为小数 */

      /** 盈利能力 */

      revenue: 营收(亿元)   operating_profit: 营业利润   net_profit: 净利润

      parent_net_profit: 归母净利润（扣除少数股东损益）

      /** 每股指标 */

      eps: 每股收益(元/股)   bps: 每股净资产(元/股)

      cash_flow_per_share: 每股经营现金流(元/股)

      /** 资产负债 */

      total_assets/liabilities/equity: 总资产/总负债/净资产(亿元)

      /** 重要比率 */

      roe: 净资产收益率(小数，如0.3253=32.53%)

      gross_margin: 毛利率(小数)   net_margin: 净利率(小数)

      debt_asset_ratio: 资产负债率(小数)

get_income_statement

获取A股利润表（损益表），展示企业在一定会计期间的经营成果，是判断企业盈利能力最重要的报表。

参数	类型	默认值	说明
code	`string`	—	A股股票代码，如 600519.SH
num	`number`	4	返回报告期数量（默认4）

      /** 关键指标解读 */

      营业利润 > 净利润：营业外收支占比较小，主业盈利稳定

      毛利率高（>50%）：企业有定价权，如茅台（90%+）、恒瑞医药（80%+）

      净利率 >> 毛利率：规模效应或费用控制优秀

      归母净利润 vs 净利润：差距越小越好，差距大说明有大量少数股东损益

get_balance_sheet

获取A股资产负债表，展示企业在特定日期的财务状况（资产、负债、权益结构）。是分析企业资产负债率、偿债能力的核心报表。

参数	类型	默认值	说明
code	`string`	—	A股股票代码，如 600519.SH
num	`number`	4	返回报告期数量（默认4）

      /** 资产负债勾稽关系: 总资产 = 总负债 + 净资产 */

      可用此公式验证数据准确性

      /** 关键指标解读 */

      资产负债率 = 总负债 / 总资产：消费/金融>70%正常，制造/科技<50%较优

      流动比率 = 流动资产 / 流动负债：>2说明短期偿债能力较好

get_cash_flow

获取A股现金流量表，展示企业一段时间内现金流入流出情况。现金流是企业的"血液"，比利润更难造假，是判断企业真实盈利能力的核心指标。

参数	类型	默认值	说明
code	`string`	—	A股股票代码，如 600519.SH
num	`number`	4	返回报告期数量（默认4）

      /** 现金流勾稽关系 */

      经营现金流 + 投资现金流 + 筹资现金流 = 现金净增加额

      /** 关键指标解读 */

      经营现金流 > 0且持续为正：主业造血能力强，健康发展

      经营现金流 < 净利润：利润可能含"水分"（应收款多、存货积压）

      经营现金流 > 净利润：利润含金量高（利润真实）

get_forecast

获取A股业绩预告（预增/预减/扭亏/首亏等），包含预测净利润区间及同比变化。

参数	类型	默认值	说明
code	`string`	—	A股股票代码，如 600519.SH
num	`number`	10	返回条数上限（默认10）

      /** 预告类型 */

      预增/预减/扭亏/首亏/续盈/续亏/不确定

      /** 返回字段 */

      report_date: 报告期   forecast_type: 预告类型

      net_profit_min/max: 预测净利润区间(亿元)

      net_profit_change: 净利润同比变化(%)   change_reason: 业绩变动原因

get_dividend

获取A股分红送转历史，包括每股现金分红、每股送股、每股转增、股权登记日、除权除息日等核心日期和数据。

参数	类型	默认值	说明
code	`string`	—	A股股票代码，如 600519.SH
num	`number`	10	返回条数上限（默认10）

      /** 分红送转类型 */

      现金分红: 将利润以现金形式分配给股东，最常见的分红方式

      送股: 将利润转为股票派发（属于利润分配，增加股本）

      转增: 将资本公积金转为股本（不属于利润分配，增加股本）

      /** 返回字段 */

      announcement_date: 公告日期   record_date: 股权登记日

      ex_dividend_date: 除权除息日   payable_date: 派息日到账日

      dividend_per_share: 每股现金分红(元/股)

      bonus_share_per_share: 每股送股(股)   transfer_per_share: 每股转增(股)

      total_dividend: 分红总额(亿元)

股票代码参考

A 股

600519.SH 贵州茅台
000001.SZ 平安银行
600036.SH 招商银行
300750.SZ 宁德时代
688981.SH 中芯国际

港股

00700.HK 腾讯控股
09988.HK 阿里巴巴
03690.HK 美团-W
01810.HK 小米集团-W

美股

AAPL 苹果
NVDA 英伟达
TSLA 特斯拉
MSFT 微软

指数

DJI 道琼斯
NDX 纳斯达克100
SPX 标普500
HSI 恒生指数
HSTECH 恒生科技

技术指标

KDJ 随机指标

通过 RSV 配合 EMA 平滑，计算 K/D/J 三条线，快速反映价格强弱与超买超卖

N=9, M1=3, M2=3（默认值）

MACD 指数平滑

利用快慢 EMA 差值判断趋势方向，零轴上方多头，下方空头

默认: 12, 26, 9

BOLL 布林带

以 MA20 为中轨，上下各偏移 N 倍标准差，构成动态通道

默认: period=20, std_dev=2.0

信号解读

指标	多头信号	空头信号	超买	超卖
KDJ	K>D 且形成金叉	K<D 且形成死叉	K/D > 80	K/D < 20
MACD	DIF > DEA（零轴上更强）	DIF < DEA（零轴下更强）	柱由绿转红放长	柱由红转绿放长
BOLL	价格贴上轨，通道开口	价格贴下轨，通道开口	position > 90%	position < 10%

为AI而生的股票MCP Server