stock-data-mcp
This server provides a comprehensive suite of 43 tools for querying financial market data, including A-shares, Hong Kong stocks, US stocks, and cryptocurrencies, with automatic failover across multiple data sources.
Key capabilities:
A-Share Market Data: Historical/real-time prices, company info, financial indicators, and tools for sentiment (dragon-tiger list, limit-up pool), fund flows, sector analysis, margin trading, block trades, shareholder data, institutional holdings, backtesting, and more.
US/HK Stock Data: Historical prices, company overviews, financial statements, earnings, insider transactions, news/sentiment, and technical indicators.
Cryptocurrency Data: OKX K-lines, loan ratios, taker volume, and Binance AI reports.
Market News & Utilities: Stock-specific and global financial news, current time/trading calendar, data source status, and symbol search.
Other Features: Automatic failover, support for multiple symbol formats, configurable via environment variables (API keys, endpoints).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@stock-data-mcp what's the latest price of AAPL?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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=trueWhen enabled, upstream will:
inject a randomized
User-Agentfetch and cache an Eastmoney
nid18tokenmerge the
nid18cookie into existing cookiesadd a small randomized delay before Eastmoney requests
Available Tools
43 toolsbacktest_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.
search查找股票代码A
根据股票名称、公司名称等关键词查找股票代码, 不支持加密货币。该工具比较耗时,当你知道股票代码或用户已指定股票代码时,建议直接通过股票代码使用其他工具
Inputs: keyword (required), market.
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_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
Scored across 43 tools
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.
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.
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).
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
Related MCP Connectors
MCP server for Financial Modeling Prep API with 250+ financial data tools
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.
MCP server for real-time China A-share stock quotes, indices and market data.
China A-share market data for research, backtesting and AI agents via MCP.
Related MCP Servers
- FlicenseBqualityDmaintenanceAn 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.243-
- FlicenseNot gradedqualityDmaintenanceMCP 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.-
- AlicenseAqualityDmaintenanceAn MCP server that gives AI assistants direct, structured access to China A-share market data.3Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA MCP server that fetches real-time Chinese stock data from East Money, supporting quotes, K-line charts, rankings, shareholder data, and more.14 npm1ISC