Skip to main content
Glama
stock-data-mcp

stock-data-mcp

stock-data-mcp

MCP 服务器,提供 A股/港股/美股、加密货币数据查询,支持多数据源自动故障转移。

PyPI

  • MCP 配置

{
  "mcpServers": {
    "stock-data": {
      "command": "uvx",
      "args": ["stock-data-mcp"]
    }
  }
}

Git 源码(开发版,会实时更新)

  • MCP 配置

{
  "mcpServers": {
    "stock-data": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/stockmcp/stock-data-mcp",
        "stock-data-mcp"
      ]
    }
  }
}

Add to Claude Code

claude mcp add stock-data
-e TUSHARE_TOKEN=your_token
-e ALPHA_VANTAGE_API_KEY=your_key
-e OKX_BASE_URL=https://okx.4url.cn
-e BINANCE_BASE_URL=https://bian.4url.cn
-- uvx stock-data-mcp


## Current Coverage

Current provides 43 tools across A-share, HK, US stock, crypto, and market/news use cases.

### A-Stock

- `index_prices` - A股指数 K 线数据
- `stock_prices` - 个股 K 线数据
- `stock_realtime` - 个股实时行情
- `stock_batch_realtime` - 批量实时行情
- `search` - 股票搜索
- `stock_info` - 个股基本信息
- `stock_indicators` - 财务指标摘要
- `get_current_time` - 当前时间与交易日历
- `stock_lhb_ggtj_sina` - 龙虎榜
- `stock_sector_fund_flow_rank` - 板块资金流排名
- `stock_margin_trading` - 融资融券
- `stock_zt_pool` - 涨停池
- `stock_north_flow` - 北向资金
- `stock_block_trade` - 大宗交易
- `stock_holder_num` - 股东人数
- `stock_chip` - 筹码分布
- `stock_fund_flow` - 个股资金流向
- `stock_sector_spot` - 板块行情
- `stock_board_cons` - 板块成分股
- `stock_market_pe_percentile` - 市场 PE 分位
- `stock_industry_pe` - 行业 PE
- `stock_dividend_history` - 分红历史
- `stock_institutional_holdings` - 基金持仓
- `stock_earnings_calendar` - 业绩披露日历
- `stock_financial_compare` - 财务对比
- `stock_locked_shares` - 限售解禁
- `stock_pledge_ratio` - 质押比例
- `stock_top10_holders` - 十大股东
- `backtest_strategy` - 回测策略

### US / HK / Crypto / Market

- `stock_prices_us` - 美股/港股 K 线
- `stock_overview_us` - 美股概览
- `stock_financials_us` - 美股财报
- `stock_earnings_us` - 美股业绩
- `stock_insider_us` - 内部交易
- `stock_news_us` - 美股新闻
- `stock_tech_indicators_us` - 美股技术指标
- `okx_prices` - OKX 行情
- `okx_loan_ratios` - OKX 借贷比
- `okx_taker_volume` - OKX 主动买卖量
- `binance_ai_report` - Binance AI 报告
- `stock_news` - 个股新闻
- `stock_news_global` - 全球财经新闻
- `data_source_status` - 数据源状态

## Symbol Formats

Upstream tools normalize common stock-code inputs before routing. This is especially relevant for `stock_prices`, `stock_realtime`, `stock_info`, and `stock_indicators`.

- A股个股: `600519`, `000001`, `sh600519`, `sz000001`, `600519.SH`, `000001.SZ`
- ETF: `510300`, `159001`, `sh510300`, `sz159001`, `510300.SH`, `159001.SZ`
- 港股: `01810`, `1810`, `HK01810`, `01810.HK`, `1810.hk`
- 美股: `AAPL`, `MSFT`, `BRK.B`

Notes:

- 港股工具会将以上输入标准化为 5 位纯数字代码,例如 `01810.HK` -> `01810`
- A股和 ETF 工具会将带市场前缀或后缀的代码标准化为 6 位纯数字代码,例如 `sh600519` -> `600519`
- 美股代码会统一转为大写,例如 `brk.b` -> `BRK.B`

## Data Sources And Failover


- A股实时: `Efinance -> Akshare -> Tushare`
- 港股实时: `Akshare -> YFinance`
- ETF 实时: `Akshare -> YFinance`
- 美股实时: `YFinance -> AlphaVantage`
- 日 K 线: `Tushare -> Efinance -> Akshare -> Pytdx -> Baostock`

## Environment Variables

| Variable | Purpose |
|----------|---------|
| `TUSHARE_TOKEN` | Tushare API token |
| `ALPHA_VANTAGE_API_KEY` | Alpha Vantage API key |
| `OKX_BASE_URL` | Custom OKX API proxy endpoint |
| `BINANCE_BASE_URL` | Custom Binance API proxy endpoint |
| `NEWSNOW_CHANNELS` | Comma-separated news source channels |
| `ENABLE_EASTMONEY_PATCH` | Set to `true` to inject randomized `User-Agent` and `nid18` token for Eastmoney requests when Eastmoney endpoints are being rate-limited |
| `LOG_LEVEL` | Logging level, default `INFO` |

## Eastmoney Patch

If Eastmoney endpoints fail frequently with `RemoteDisconnected`, abrupt resets, or similar rate-limit style errors, enable:

```bash
export ENABLE_EASTMONEY_PATCH=true

When enabled, upstream will:

  • inject a randomized User-Agent

  • fetch and cache an Eastmoney nid18 token

  • merge the nid18 cookie into existing cookies

  • add a small randomized delay before Eastmoney requests

Available Tools

43 tools
backtest_strategyA股策略回测B

对股票进行简单策略回测,支持均线交叉、MACD、KDJ等策略,返回收益率、最大回撤、胜率等指标。

Inputs: symbol (required), ma_long, end_date, ma_short, +3 more.

binance_ai_report获取加密货币分析报告B

获取币安对加密货币的AI分析报告,此工具对分析加密货币非常有用。支持自动重试。

Inputs: symbol.

data_source_status查看数据源状态A

查看多数据源的状态和熔断器信息

Inputs: no named parameters.

get_current_time获取当前时间及A股交易日信息A

获取当前系统时间及A股交易日信息,建议在调用其他需要日期参数的工具前使用该工具

Inputs: no named parameters.

index_prices获取A股指数历史价格A

根据A股指数代码获取指数历史价格及技术指标,例如 000300(沪深300)。

Inputs: limit, period, symbol.

okx_loan_ratios获取加密货币杠杆多空比C

获取OKX加密货币借入计价货币与借入交易货币的累计数额比值。支持自动重试。

Inputs: period, symbol.

okx_prices获取加密货币历史价格A

获取OKX加密货币的历史K线数据,包括价格、交易量和技术指标。支持自动重试。

Inputs: bar, limit, instId.

okx_taker_volume获取加密货币主动买卖情况B

获取OKX加密货币主动买入和卖出的交易量。支持自动重试。

Inputs: period, symbol, instType.

stock_batch_realtime批量获取实时行情A

批量获取多只A股实时行情数据。支持多数据源自动故障转移。

Inputs: symbols (required), limit.

stock_block_tradeA股大宗交易A

获取A股大宗交易数据,包括成交价、成交量、溢价率等。大宗交易反映机构大额交易动向。

Inputs: limit, symbol.

stock_board_cons获取板块成分股A

获取行业或概念板块的成分股列表。支持多数据源自动故障转移。

Inputs: board_name (required), limit, board_type.

stock_chip获取筹码分布A

获取A股筹码分布数据,包括获利比例、平均成本、成本区间、筹码集中度等。

Inputs: symbol (required).

stock_dividend_historyA股分红历史A

获取A股个股历史分红送转数据,包括派息、送股、转增等。用于分析股息率和分红政策。

Inputs: symbol (required), limit.

stock_earnings_calendarA股财报日历B

获取A股财报披露时间表,查看即将披露财报的公司。用于跟踪财报季。

Inputs: limit, period.

stock_earnings_us美股盈利数据A

获取美股历史盈利数据和分析师预期。支持多数据源: Alpha Vantage (需API key) -> yfinance (免费)。

Inputs: symbol (required).

stock_financial_compareA股财务指标对比B

获取A股个股详细财务指标,包括盈利能力、偿债能力、运营能力等多维度分析。

Inputs: symbol (required).

stock_financials_us美股财务报表B

获取美股财务报表数据,包括资产负债表、利润表、现金流量表。支持多数据源: Alpha Vantage (需API key) -> yfinance (免费)。

Inputs: symbol (required), quarterly, report_type.

stock_fund_flow获取个股资金流向A

获取A股个股的资金流向数据,包括主力、超大单、大单、中单、小单的流入流出情况。支持多数据源自动故障转移。

Inputs: symbol (required).

stock_holder_numA股股东人数B

获取A股股东户数变化数据,筹码集中度的重要指标。股东人数减少通常意味着筹码趋于集中。

Inputs: symbol (required).

stock_indicators股票财务指标C

获取股票财务报告关键指标,支持A股、港股、美股市场

Inputs: symbol (required), market.

stock_industry_peA股行业PE对比A

获取A股各行业PE对比数据,用于行业估值比较和行业轮动分析。

Inputs: date.

stock_info获取股票信息A

根据股票代码和市场获取股票基本信息, 不支持加密货币

Inputs: symbol (required), market.

stock_insider_us美股内部交易A

获取美股公司内部人交易记录。支持多数据源: Alpha Vantage (需API key) -> yfinance (免费)。

Inputs: symbol (required), limit.

stock_institutional_holdingsA股基金持仓A

获取A股基金重仓股数据,显示公募基金持仓最多的股票及持仓变化。用于跟踪机构动向。

Inputs: date, limit.

stock_lhb_ggtj_sinaA股龙虎榜统计B

获取中国A股市场(上证、深证)的龙虎榜个股上榜统计数据。支持多数据源。

Inputs: days, limit.

stock_locked_sharesA股限售解禁日历A

获取A股限售股解禁日历,查看即将解禁的股票及解禁规模。限售解禁是重要的市场供给压力指标。

Inputs: mode, limit, end_date, start_date.

stock_margin_tradingA股融资融券B

获取A股市场融资融券数据,包括融资余额、融券余额等。融资融券是衡量市场杠杆资金的重要指标。

Inputs: limit, market, symbol.

stock_market_pe_percentileA股市场PE分位A

获取A股市场整体PE/PB的历史分位数,用于判断市场整体估值水平。

Inputs: no named parameters.

stock_news获取股票/加密货币相关新闻B

根据股票代码或加密货币符号获取近期相关新闻

Inputs: symbol (required), limit.

stock_news_global全球财经快讯A

获取最新的全球财经快讯

Inputs: no named parameters.

stock_news_us美股新闻情绪B

获取美股相关新闻及情绪分析数据。需要配置 ALPHA_VANTAGE_API_KEY 环境变量。

Inputs: limit, symbol, topics.

stock_north_flow沪深港通北向资金A

获取沪深港通北向资金(外资)流向数据,包括沪股通、深股通的资金净流入情况。北向资金是A股重要的风向标。

Inputs: indicator.

stock_overview_us美股公司概览A

获取美股公司基本面概览,包括市值、PE、EPS、股息率、52周高低点、分析师评级等。支持多数据源: Alpha Vantage (需API key) -> yfinance (免费)。

Inputs: symbol (required).

stock_pledge_ratioA股股权质押B

获取A股股权质押数据,包括行业质押统计和市场整体质押比例。股权质押是衡量大股东杠杆风险的重要指标。

Inputs: mode, limit.

stock_prices获取股票历史价格A

根据股票代码和市场获取股票历史价格及技术指标, 不支持加密货币。支持多数据源自动故障转移。

Inputs: symbol (required), limit, market, period.

stock_prices_us获取美股/港股历史价格B

获取美股或港股的历史价格数据及技术指标。支持多数据源自动故障转移。

Inputs: symbol (required), limit, market, period.

stock_realtime获取股票实时行情A

获取A股/港股实时行情数据,包括最新价、涨跌幅、成交量、换手率、市盈率等。支持多数据源自动故障转移。

Inputs: symbol (required), market.

stock_sector_fund_flow_rankA股板块资金流C

获取中国A股市场(上证、深证)的行业资金流向数据

Inputs: cate, days.

stock_sector_spot获取个股所属板块B

获取A股个股所属的行业和概念板块信息

Inputs: symbol (required).

stock_tech_indicators_us美股技术指标A

获取美股技术分析指标数据,如SMA、EMA、RSI、MACD、布林带等。需要配置 ALPHA_VANTAGE_API_KEY 环境变量。

Inputs: symbol (required), limit, interval, indicator, +1 more.

stock_top10_holdersA股十大股东A

获取A股个股十大股东或十大流通股东信息,用于分析股权结构和机构持仓变化。

Inputs: symbol (required), limit, holder_type.

stock_zt_poolA股涨停/强势股池B

获取中国A股市场(上证、深证)的涨停股池或强势股池数据

Inputs: date, limit, pool_type.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 43 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes with detailed descriptions. However, there is some overlap between stock_prices (multiple markets) and stock_prices_us (US/HK), and between stock_financial_compare and stock_indicators (both provide financial indicators for A-shares). Overall, ambiguity is low.

    Naming Consistency3/5

    The naming convention is mixed: stock market tools use the 'stock_' prefix consistently, but crypto tools use 'okx_' and 'binance_' prefixes, and utility tools like 'search' and 'get_current_time' have no prefix. This creates inconsistency, though within each group patterns are clear.

    Tool Count3/5

    With 43 tools, the server is on the heavy side for an MCP server. While each tool has a specific purpose and covers a broad domain (A-shares, US/HK stocks, crypto), the count is borderline high and could be reduced by merging some overlapping tools (e.g., stock_prices and stock_prices_us).

    Completeness4/5

    The tool surface is very comprehensive for A-shares, covering real-time, historical, financials, fund flows, news, and more. For US stocks, it includes earnings, financials, insider transactions, and news, but lacks real-time quotes. Crypto coverage is limited to OKX data and a Binance report. Minor gaps exist, but the overall coverage is strong.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      An MCP server that exposes all 23 baostock data endpoints as tools, including K-line, quarterly financials, performance reports, dividends, industry classification, index constituents, and macro series.
      24
      3
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server that wraps SFC financial data API into 32 tools for comprehensive A-share market data, including real-time quotes, rankings, limit-up statistics, news, themes, financials, charts, research reports, and watchlists.
      -
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that gives AI assistants direct, structured access to China A-share market data.
      3
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A MCP server that fetches real-time Chinese stock data from East Money, supporting quotes, K-line charts, rankings, shareholder data, and more.
      14 npm
      1
      ISC