Content
# Tushare MCP Server
MCP (Model Context Protocol) based Tushare financial data server, providing 52 professional financial data analysis tools.
## 🎯 Project Features
- ✅ **52 Professional Tools** - Covering 10 categories including stocks, futures, foreign exchange, finance, etc.
- ✅ **Dual Mode Support** - stdio mode and HTTP SSE mode
- ✅ **Intelligent Cache** - Automatic cache management to improve query efficiency
- ✅ **Permission Management** - Supports different Tushare permission levels
- ✅ **Out-of-the-Box** - Automatic tool discovery and registration
## 📦 Quick Start
### 1. Install Dependencies
```bash
pip install -r requirements.txt
```
### 2. Configure Tushare Token
Create a `.env` file in the project root directory:
```env
TUSHARE_TOKEN=your_token_here
```
Get Token: [https://tushare.pro/user/token](https://tushare.pro/user/token)
### 3. Choose Running Mode
#### Method A: stdio Mode (Recommended for Claude Desktop)
**Configuration File**: `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
```json
{
"mcpServers": {
"tushare": {
"command": "python",
"args": ["D:/AI/tushare_MCP/server.py"]
}
}
}
```
**Start**: Restart Claude Desktop to start automatically
#### Method B: Streamable HTTP Mode (Recommended for Debugging and Remote Access)
**Start Server**:
```bash
# Windows
start_http_server.bat
# Linux/macOS
chmod +x start_http_server.sh
./start_http_server.sh
```
**Configuration File**: Same as Claude Desktop configuration file
```json
{
"mcpServers": {
"tushare-http": {
"url": "http://127.0.0.1:8000/mcp"
}
}
}
```
## 🛠️ Mode Comparison
| Feature | stdio Mode | Streamable HTTP Mode |
|------|-----------|--------------|
| **Communication Method** | Standard Input/Output | HTTP JSON-RPC |
| **Network Access** | ❌ Only Local Process | ✅ Supports Network Access |
| **Concurrent Connections** | ❌ Single Client | ✅ Multiple Clients |
| **Debugging Difficulty** | 🔴 Difficult | 🟢 Easy (can be tested with curl) |
| **Applicable Scenarios** | Local Single User | Development Debugging, Multi-User, Remote Access |
| **Configuration Method** | `command` + `args` | `url` |
## 📊 Tool List
Tushare MCP tool complete list
This document lists all supported MCP tools, a total of 52 tools, divided into 10 categories.
📊 1. Alpha Strategy Analysis Tools (6)
### Industry Alpha Analysis
#### analyze_sector_alpha_strategy
Function: Analyze the relative strength Alpha of a single sector, calculate 2-day and 5-day Alpha returns
Parameters: `sector_code` (sector code, required), `benchmark_code` (benchmark index, default 000300.SH), `end_date` (end date, YYYYMMDD format, default today)
Description: Calculate 2-day and 5-day interval returns, calculate excess return Alpha = sector return - benchmark return, comprehensive score = Alpha_2 × 60% + Alpha_5 × 40%
#### rank_sectors_by_alpha
Function: Shenwan Level 1 industry Alpha ranking, display top N strong sectors
Parameters: `benchmark_code` (benchmark index, default 000300.SH), `end_date` (end date, YYYYMMDD format, default today), `top_n` (display top N, default 10)
Description: Automatically analyze all 31 Shenwan Level 1 industries, sorted in descending order by comprehensive score
#### rank_l2_sectors_by_alpha
Function: Shenwan Level 2 industry Alpha ranking, display top N strong sectors
Parameters: `benchmark_code` (benchmark index, default 000300.SH), `end_date` (end date, YYYYMMDD format, default today), `top_n` (display top N, default 20)
Description: Automatically analyze all Shenwan Level 2 industries with published indices, sorted in descending order by comprehensive score
#### rank_l1_sectors_alpha_full
Function: Shenwan Level 1 industry Alpha comprehensive score complete ranking (all 31 industries)
Parameters: `benchmark_code` (benchmark index, default 000300.SH), `end_date` (end date, YYYYMMDD format, default today)
Description: Display complete ranking of all Shenwan Level 1 industries
#### rank_l1_sectors_alpha_velocity
Function: Shenwan Level 1 industry Alpha ranking rising speed analysis
Parameters: `benchmark_code` (benchmark index, default 000300.SH), `end_date` (end date, YYYYMMDD format, default today)
Description: Calculate ranking rising speed (change in ranking compared to the previous day and two days ago), positive indicates rising ranking, negative indicates falling ranking
#### rank_l2_sectors_alpha_velocity
Function: Shenwan Level 2 industry Alpha ranking rising speed analysis
Parameters: `benchmark_code` (benchmark index, default 000300.SH), `end_date` (end date, YYYYMMDD format, default today), `top_n` (display top N, default 20)
Description: Calculate ranking rising speed, including one-day and two-day rising rankings
📈 2. Stock Market Tools (22)
### Stock Basic Information
#### get_stock_basic_info
Function: Get stock basic information (code, name, listing date, industry, etc.)
Parameters: `ts_code` (stock code, e.g., 000001.SZ) or `name` (stock name, e.g., Ping An Bank)
Description: Support query by code or name
#### search_stocks
Function: Search stocks, support fuzzy matching by code or name
Parameters: `keyword` (keyword, required, can be part of stock code or stock name)
Description: Support fuzzy search, return list of matching stocks
### Stock Market Data
#### get_stock_daily
Function: Get A-share daily market data (open, close, high, low, volume, etc.)
Parameters: `ts_code` (stock code, support multiple, separated by commas), `trade_date` (trading date, YYYYMMDD format), `start_date`/`end_date` (date range, YYYYMMDD format)
Description: Support single stock or batch query, support single day or date range query, data updated between 15:00-16:00 on trading days, unadjusted
#### get_stock_weekly
Function: Get A-share weekly market data, support single stock or batch query
Parameters: `ts_code` (stock code, required, support multiple, separated by commas), `trade_date` (trading date, YYYYMMDD format), `start_date`/`end_date` (date range, YYYYMMDD format)
Description: `trade_date` is the last trading day of the week (usually Friday), weekly data updated once a week, unadjusted
#### get_stock_min
Function: Get A-share real-time minute market data
Parameters: `ts_code` (stock code, required, e.g., 600000.SH, support multiple stocks, separated by commas), `freq` (minute frequency, required, default 1MIN: 1MIN/5MIN/15MIN/30MIN/60MIN), `date_str` (playback date, optional, format: YYYY-MM-DD, default trading day, support backtracking one day)
Description: Data source: Tushare `rt_min` interface (real-time) or `rt_min_daily` interface (historical playback), support 1min/5min/15min/30min/60min market data, display open, high, low, close, volume, turnover, etc., require separate permission, maximum 1000 rows of data per query, support multiple stocks extracted simultaneously
#### get_stock_rt_k
Function: Get real-time daily market data for Shanghai, Shenzhen, and Beijing
Parameters: `ts_code` (stock code, required, support wildcard: single stock e.g., 600000.SH, 000001.SZ, 430047.BJ, wildcard e.g., 6*.SH, 301*.SZ, 0*.SZ, 9*.BJ, multiple stocks or wildcards e.g., 600000.SH,000001.SZ, codes must have .SH/.SZ/.BJ suffix)
Description: Data source: Tushare `rt_k` interface, get real-time daily K-line market data, support extracting all stocks' real-time daily K-line market data at once by stock code or wildcard, display open, high, low, close (latest price), volume, turnover, number of transactions, buy and sell orders, etc., this interface requires separate permission, maximum 6000 rows of data per query, equivalent to extracting the entire market at once
### ETF Fund
#### get_etf_daily
Function: Get ETF daily market data, support single ETF or batch query
Parameters: `ts_code` (ETF fund code, support multiple, separated by commas), `trade_date` (trading date, YYYYMMDD format), `start_date`/`end_date` (date range, YYYYMMDD format)
Description: Common ETF codes: 510330.SH (Huaxia SSE 300 ETF), 510300.SH (SSE 300 ETF), 159919.SZ (SSE 300 ETF), get ETF market data after daily close, history over 10 years, maximum 2000 rows of data per query
### A-share Index
#### get_index_daily
Function: Get A-share index daily market data (SSE 300, Shanghai Composite, Shenzhen Component, etc.)
Parameters: `ts_code` (index code, support multiple, separated by commas), `trade_date` (trading date, YYYYMMDD format), `start_date`/`end_date` (date range, YYYYMMDD format)
Description: Common index codes: 000300.SH (SSE 300), 000001.SH (Shanghai Composite), 399001.SZ (Shenzhen Component), 399006.SZ (ChiNext), data updated between 15:00-16:00 on trading days, unadjusted
### Restricted Share Unlock Data
#### get_share_float
Function: Get restricted share unlock data
Parameters: `ts_code` (stock code, e.g., 000998.SZ, optional), `ann_date` (announcement date, YYYYMMDD format, optional), `float_date` (unlock date, YYYYMMDD format, optional), `start_date`/`end_date` (unlock date range, YYYYMMDD format, optional)
Description: Data source: Tushare `share_float` interface, support filtering by stock code, announcement date, unlock date, date range, display unlock date, circulating shares, proportion of circulating shares to total shares, shareholder name, share type, etc., require 2000 points permission
### Stock Repurchase Data
#### get_stock_repurchase
Function: Get listed company stock repurchase data
Parameters: `ann_date` (announcement date, YYYYMMDD format, e.g., 20181010, optional), `start_date`/`end_date` (announcement date range, YYYYMMDD format, optional)
Description: Data source: Tushare `repurchase` interface, support filtering by announcement date, date range, display announcement date, deadline, progress, expiration date, repurchase quantity, repurchase amount, highest repurchase price, lowest repurchase price, etc., require 600 points permission, note: if no parameters are filled, default return 2000 rows of data
### Share Pledge Data
#### get_pledge_detail
Function: Get stock share pledge detailed data
Parameters: `ts_code` (stock code, required, e.g., 000014.SZ)
Description: Data source: Tushare `pledge_detail` interface, display stock pledge detailed data, including announcement date, shareholder name, pledge quantity, pledge start/end date, whether pledged, pledge date, pledge party, total holding shares, total pledge shares, pledge ratio, etc., require 500 points permission, maximum 1000 rows of data per query
### Block Trade Data
#### get_block_trade
Function: Get block trade data
Parameters: `ts_code` (stock code, e.g., 600436.SH, optional), `trade_date` (trading date, YYYYMMDD format, e.g., 20181227, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional)
Description: Data source: Tushare `block_trade` interface, support filtering by stock code, trading date, date range, display trading date, transaction price, volume, transaction amount, buying brokerage, selling brokerage, etc., permission requirements please check Tushare documentation
### Announcement Signal Scan
#### scan_announcement_signals
Function: Scan listed company announcement titles, capture [Major Positive] or [Major Negative] signals
Parameters: `ts_code_list` (stock code list, multiple codes separated by commas, e.g., 000001.SZ,600000.SH, optional, if empty, scan the entire market), `check_date` (announcement date, YYYYMMDD format, e.g., 20230621, optional, default today), `start_date`/`end_date` (date range, YYYYMMDD format, optional)
Description: Data source: Tushare `anns_d` interface, automatically classify announcement titles into: positive catalyst, negative alert, major matters, support filtering by stock code list and date, permission requirements: this interface is a separate permission, please refer to Tushare permission instructions, limit: maximum 2000 rows of data per query, can be obtained in batches by date
### Shareholder Data
#### get_stock_holder_trade
Function: Get listed company shareholder increase/decrease holdings data
Parameters: `ts_code` (stock code, optional), `ann_date` (announcement date, YYYYMMDD format, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional), `trade_type` (trading type: IN increase/DE decrease, optional), `holder_type` (shareholder type: C company/P individual/G executive, optional)
Description: Data source: listed company announcements, display increase/decrease holdings quantity, proportion of circulating shares, average price, etc., at least one query condition required
#### get_stock_holder_number
Function: Get listed company shareholder number data
Parameters: `ts_code` (stock code, optional), `ann_date` (announcement date, YYYYMMDD format, optional), `enddate` (截止日期, YYYYMMDD format, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional)
Description: Data source: listed company periodic reports, shareholder number changes can reflect stock concentration changes, at least one query condition required
### Institutional Research Data
#### get_stock_survey
Function: Get listed company institutional research records data
Parameters: `ts_code` (stock code, optional), `trade_date` (research date, YYYYMMDD format, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional)
Description: Data source: listed company disclosed institutional research records, display participating institutions, reception location, reception method, reception company, etc., require 5000 points permission, maximum 100 rows of data per query, at least one query condition required
### Chip Analysis Data
#### get_cyq_perf
Function: Get A-share daily chip average cost and win rate
Parameters: `ts_code` (stock code, required), `trade_date` (trading date, YYYYMMDD format, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional)
Description: Data updated around 17:00-18:00 daily, starting from 2018, automatically calculate chip concentration, require 5000 points permission, maximum 5000 rows of data per query, chip concentration calculation formula: concentration = (cost_95pct - cost_5pct) / (cost_95pct + cost_5pct), smaller concentration indicates more concentrated chips; larger concentration indicates more dispersed chips
### Margin Trading Data
#### get_margin
Function: Get daily margin trading summary data (by exchange)
Parameters: `trade_date` (trading date, YYYYMMDD format, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional), `exchange_id` (exchange code: SSE Shanghai/SZSE Shenzhen/BSE Beijing, optional)
Description: Data source: securities exchange website, provide margin balance, margin purchase amount, margin repayment amount, short selling balance, etc., require 2000 points permission, maximum 4000 rows of data per query
#### get_margin_detail
Function: Get margin trading detailed data (by stock code)
Parameters: `ts_code` (stock code, support multiple, separated by commas, optional), `trade_date` (trading date, YYYYMMDD format, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional)
Description: Data source: securities companies' margin trading balance data, provide margin and short selling details for each stock, require 2000 points permission, maximum 4000 rows of data per query, at least one query condition required
### Capital Flow Data
#### get_stock_moneyflow_dc
Function: Get Dongfang Fortune stock capital flow data
Parameters: `ts_code` (stock code, leave blank to query all stocks, optional), `trade_date` (trading date, YYYYMMDD format, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional)
Description: Data source: Dongfang Fortune, updated daily after close, starting from 20230911, display main net inflow, net inflow of super large orders/large orders/medium orders/small orders and their proportions, require 5000 points permission, maximum 6000 rows of data per query, at least one query condition required
### Daily Indicator Data
#### get_daily_basic
Function: Get daily indicator data (valuation indicators, turnover rate, volume ratio, market value, etc.)
Parameters: `ts_code` (stock code, support multiple, separated by commas, optional), `trade_date` (trading date, YYYYMMDD format, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional)
Description: Include valuation indicators (PE, PB, PS), turnover rate, volume ratio, total market value, circulating market value, etc., support query by stock code, trading date, date range, at least one query condition required
### Dragon and Tiger List Data
#### get_top_list
Function: Get daily Dragon and Tiger List transaction details
Parameters: `trade_date` (trading date, required, YYYYMMDD format), `ts_code` (stock code, optional)
Description: Data source: Tushare `top_list` interface, data history from 2005 to present, display close price, price change rate, turnover rate, total transaction amount, buy/sell amount on Dragon and Tiger List, net buy amount, reasons for inclusion, etc., require 2000 points permission, maximum 10000 rows of data per query
#### get_top_inst
Function: Get Dragon and Tiger List institutional transaction details
Parameters: `trade_date` (trading date, required, YYYYMMDD format), `ts_code` (stock code, optional)
Description: Data source: Tushare `top_inst` interface, display brokerage name, trading type (top 5 buy/sell amount), buy amount, sell amount, net transaction amount, buy/sell proportion, reasons for inclusion, etc., require 5000 points permission, maximum 10000 rows of data per query
📊 3. Index Market Tools (4)
### International Index
#### get_global_index
Function: Get international major index market data (Dow Jones, S&P 500, Nasdaq, etc.)
Parameters: `index_code` (index code, e.g., XIN9, HSI, DJI, SPX, IXIC, optional), `index_name` (index name, optional), `trade_date` (trading date, YYYYMMDD format, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional)
Description: Support over 20 international major indices, including FTSE China A50, Hang Seng Index, Dow Jones, S&P 500, Nasdaq, Nikkei 225, etc., at least one query condition required
### Search Global Indexes
#### search_global_indexes
Function: Search available international indices, support keyword filtering
Parameters: `keyword` (search keyword, optional, leave blank to display all available indices)
Description: Return list of all supported international indices, or filter by keyword
### Industry Index
#### get_sw_industry_daily
Function: Get Shenwan industry index daily market data (Level 1, 2, 3 industries)
Parameters: `ts_code` (index code, optional), `trade_date` (trading date, YYYYMMDD format, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional), `level` (industry level: L1/L2/L3, default L1)
Description: L1 for Level 1 industry (e.g., mining, chemicals, steel, etc.), L2 for Level 2 industry, L3 for Level 3 industry, data updated between 15:00-16:00 on trading days, unadjusted
#### get_industry_index_codes
Function: Get Shenwan industry classification index code list (L1/L2/L3)
Parameters: `level` (industry level: L1/L2/L3, default L1), `src` (index source: SW2014/SW2021, default SW2021)
Description: Return Shenwan industry classification index code list, including index code, industry name, industry code, etc.
💱 4. Forex Tools (1)
#### get_fx_daily
Function: Get forex daily market data (USD/CNY, EUR/USD, etc.)
Parameters: `ts_code` (currency pair code, support multiple, separated by commas, optional), `trade_date` (trading date, YYYYMMDD format, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional)
Description: Common currency pair codes: USDCNH.FXCM (USD/CNY), EURUSD.FXCM (EUR/USD), GBPUSD.FXCM (GBP/USD), USDJPY.FXCM (USD/JPY), at least one of transaction pair code (ts_code) or trading date (trade_date) required
📈 5. Futures Tools (5)
#### get_fut_basic
Function: Get futures contract basic information
Parameters: `exchange` (exchange code, required: CFFEX/CZCE/DCE/SHFE/INE/GFEX), `fut_type` (contract type: 1 normal contract/2 main and continuous contracts, optional), `fut_code` (standard contract code, e.g., AG, AP, optional), `list_date` (listing start date, YYYYMMDD format, optional)
Description: Display contract code, trading identifier, trading market, Chinese name, contract product code, contract multiplier, trading unit, quote unit, listing date, last trading date, delivery month, last delivery date, etc.
#### get_nh_index
Function: Get Nanhua futures index daily market data
Parameters: `ts_code` (index code, support multiple, separated by commas, optional), `trade_date` (trading date, YYYYMMDD format, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional)
Description: Data source: Tushare `index_daily` interface, display open, high, low, close, change point, change rate, volume, turnover, etc., common indices: NHCI.NH (Nanhua Commodity Index), NHAI.NH (Nanhua Agricultural Index), CU.NH (Nanhua Shanghai Copper Index), AU.NH (Nanhua Shanghai Gold Index), etc., require 2000 points permission, at least one query condition required
#### get_fut_holding
Function: Get daily futures holding ranking data
Parameters: `trade_date` (trading date, YYYYMMDD format, optional), `symbol` (contract or product code, e.g., C1905, C, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional), `exchange` (exchange code, optional: CFFEX/DCE/CZCE/SHFE/INE/GFEX)
Description: Data source: Tushare `fut_holding` interface, display volume, change in volume, long position, change in long position, short position, change in short position, etc., require 2000 points permission, maximum 5000 rows of data per query, at least one query condition required
#### get_fut_wsr
Function: Get daily futures warehouse receipt data
Parameters: `trade_date` (trading date, YYYYMMDD format, optional), `symbol` (product code, e.g., ZN zinc, CU copper, optional), `start_date`/`end_date` (date range, YYYYMMDD format, optional), `exchange` (exchange code, optional: CFFEX/DCE/CZCE/SHFE/INE/GFEX)
Description: Data source: Tushare `fut_wsr` interface, display changes in warehouse receipts for each warehouse/plant, including previous warehouse receipts, current warehouse receipts, increase/decrease, etc., require 2000 points permission, maximum 1000 rows of data per query, at least one query condition required
#### get_fut_min
Function: Get real-time futures minute market data
# Tool List
## Function: Get Real-time Futures Minute Data
Parameters: ts_code (futures contract code, required, e.g., CU2501.SHF, supports multiple contracts, comma-separated), freq (minute frequency, required, default 1MIN: 1MIN/5MIN/15MIN/30MIN/60MIN), date_str (playback date, optional, format: YYYY-MM-DD, default trading day, supports backtracking one day)
Description: Data source: Tushare rt_fut_min interface (real-time) or rt_fut_min_daily interface (historical playback), supports 1min/5min/15min/30min/60min market data, displays open, high, low, close, volume, turnover, position data, requires separate permission, can request 500 times per minute, supports multiple contracts to extract at once
## Financial Statement Tools (2)
### get_income_statement
Function: Get profit statement data, supports consolidated statements and parent company statements
Parameters: ts_code (stock code, required), start_date (start date, YYYYMMDD format, optional), end_date (end date, YYYYMMDD format, optional), report_type (report type, default 1 consolidated statement, optional values: 1-12)
Description: Supports 12 report types, including consolidated statements, single quarter consolidated statements, parent company statements, etc.
### get_fina_indicator
Function: Get financial indicator data (profitability, growth ability, operation ability, debt-paying ability, etc.)
Parameters: ts_code (stock code, optional), ann_date (announcement date, YYYYMMDD format, optional), start_date/end_date (report period date range, YYYYMMDD format, optional), period (report period, optional)
Description: Data source: listed company regular reports, published 4 times a year (quarterly report, semi-annual report, quarterly report, annual report), includes ROE, ROA, gross margin, net profit margin, asset-liability ratio, turnover rate, and other financial indicators, requires at least one query condition
## Concept Sector Tools (8)
### Concept Sector Data
#### get_eastmoney_concept_board
Function: Get Eastmoney concept sector market data
Parameters: ts_code (sector code, supports multiple, comma-separated, e.g., BK1186.DC,BK1185.DC, optional), name (sector name, e.g., humanoid robot, optional), trade_date (trading date, YYYYMMDD format, optional), start_date/end_date (date range, YYYYMMDD format, optional)
Description: Requires 6000 points permission, returns sector code, sector name, price change, leading stock, total market value, turnover rate, etc., maximum 5000 data can be obtained at one time, requires at least one query condition
#### get_eastmoney_concept_member
Function: Get Eastmoney sector daily constituent data
Parameters: ts_code (sector index code, e.g., BK1184.DC humanoid robot, optional), con_code (constituent stock code, e.g., 002117.SZ, optional), trade_date (trading date, YYYYMMDD format, optional)
Description: Can obtain historical constituents according to concept sector code and trading date; can also query which concept sectors a stock belongs to, requires 6000 points permission, maximum 5000 data can be obtained at one time, requires at least one query condition
#### get_eastmoney_concept_daily
Function: Get Eastmoney concept sector, industry index sector, regional sector market data
Parameters: ts_code (sector code, format: xxxxx.DC, e.g., BK1184.DC, optional), trade_date (trading date, YYYYMMDD format, optional), start_date/end_date (date range, YYYYMMDD format, optional), idx_type (sector type: concept sector/industry sector/regional sector, optional)
Description: Historical data starts from 2020, maximum 2000 data can be obtained at one time, requires 6000 points permission, requires at least one query condition
## Concept Sector Alpha Analysis
### analyze_concept_alpha_strategy
Function: Analyze the relative strength Alpha of a single Eastmoney concept sector
Parameters: concept_code (concept sector code, required, e.g., BK1184.DC humanoid robot, BK1186.DC first economic, etc.), benchmark_code (benchmark index, default 000300.SH), end_date (end date, YYYYMMDD format, default today)
Description: Calculate 2-day and 5-day interval yield, calculate excess return Alpha, comprehensive score = Alpha_2 × 60% + Alpha_5 × 40%
### rank_concepts_by_alpha
Function: Concept sector Alpha ranking, calculate excess return relative to Shanghai and Shenzhen 300
Parameters: benchmark_code (benchmark index, default 000300.SH), end_date (end date, YYYYMMDD format, default today), top_n (display top N, default 20), hot_limit (screening popular concept sector quantity, default 80, screened by turnover and turnover rate)
Description: Automatically obtain specified date popular concept sectors (screened by turnover and turnover rate), arranged in descending order of comprehensive score, display top N strong sectors, only analyze popular sectors to reduce calculation amount and improve response speed
### rank_concepts_alpha_velocity
Function: Concept sector Alpha ranking rising speed, identify rapidly rising concept sectors
Parameters: benchmark_code (benchmark index, default 000300.SH), end_date (end date, YYYYMMDD format, default today)
Description: Calculate ranking rising speed (compare today with yesterday and two days ago), positive number indicates ranking rising, negative number indicates ranking falling
## Sector Capital Flow
### get_concept_moneyflow_dc
Function: Get Eastmoney sector capital flow data (concept, industry, regional)
Parameters: ts_code (sector code, e.g., BK1184.DC, leave blank to query all sectors, optional), trade_date (trading date, YYYYMMDD format, optional), start_date/end_date (date range, YYYYMMDD format, optional), content_type (capital type: industry/concept/region, leave blank to query all types, optional)
Description: Data source: Eastmoney, updated daily after market close, displays main capital inflow, super large order/large order/medium order/small order net inflow and proportion, main capital inflow maximum stock, ranking, etc., requires 5000 points permission, maximum 5000 data can be obtained at one time, requires at least one query condition
## Concept Sector Volume Anomaly
### scan_concepts_volume_anomaly
Function: Analyze Eastmoney concept sector volume anomaly
Parameters: end_date (end date, YYYYMMDD format, default today, optional), vol_ratio_threshold (volume ratio threshold, default 1.15, i.e., MA3/MA10 > 1.15, capital inflow), price_change_5d_min (5-day price change minimum, default 0.02, i.e., 2%, right start), price_change_5d_max (5-day price change maximum, default 0.08, i.e., 8%, refuse left fish), hot_limit (scanned popular concept sector quantity, default 160, screened by turnover and turnover rate)
Description: Scan popular Eastmoney concept sectors (screened by turnover and turnover rate), calculate indicators: Volume_Ratio = MA3_Vol / MA10_Vol, Price_Change_5d (5-day price change), Turnover_Rate (turnover rate), screening logic: Volume_Ratio > vol_ratio_threshold (capital inflow) and price_change_5d_min < Price_Change_5d < price_change_5d_max (right start), return JSON format string
## Volume Anomaly Analysis Tool (1)
### scan_l2_volume_anomaly
Function: Scan SWAN Level 2 industry volume anomaly, identify volume-price divergence signal
Parameters: end_date (end date, YYYYMMDD format, default today, optional), vol_ma_short (volume short-term MA days, default 3, i.e., MA3, can be set to 1, 3, 5, etc.), vol_ma_long (volume long-term MA days, default 10, i.e., MA10, can be set to 3, 5, 10, 20, etc.), vol_ratio_threshold (volume ratio threshold, default 1.5, i.e., MA short/MA long > 1.5), price_change_5d_threshold (5-day price change threshold, default 0.03, i.e., 3%)
Description: Screening conditions: (volume MA short/volume MA long) > threshold and near 5-day price change < threshold, judge signal type according to price position (high > 70% percentile: distribution signal, low < 30% percentile or above moving average: accumulation signal, other: to be confirmed), return JSON format string
## Cache Management Tool (1)
### get_cache_stats
Function: Get cache statistics information (cache quantity, access times, etc.)
Parameters: None
Description: Display all cache type statistics information, including cache quantity and access times
## Usage Instructions
### Date Format
All date parameters format: YYYYMMDD (e.g., 20250102)
If not provided, default use today
Playback date format: YYYY-MM-DD (e.g., 2025-01-02)
### Benchmark Index
Alpha analysis default benchmark index: 000300.SH (Shenzhen and Shanghai 300)
Can customize benchmark index code
### Data Source
Concept sector data: Eastmoney (requires 6000 points permission)
Industry data: Tushare (SWAN industry classification)
Stock data: Tushare
International index: Tushare
Futures data: Tushare
### Cache Mechanism
All tools support cache, improve query efficiency
Cache data permanently retained, marked status after expiration
Can use get_cache_stats to view cache statistics
### Permission Requirements
Most tools require basic Tushare permission
2000 points permission tools:
- get_nh_index (Nanhua futures index)
- get_margin (margin trading summary)
- get_margin_detail (margin trading details)
- get_top_list (dragon and tiger list daily details)
- get_fut_holding (futures position ranking)
- get_fut_wsr (futures warehouse receipt daily)
- get_share_float (restricted stock lifting)
5000 points permission tools:
- get_stock_survey (institutional survey)
- get_cyq_perf (chip analysis)
- get_stock_moneyflow_dc (stock capital flow)
- get_concept_moneyflow_dc (sector capital flow)
- get_top_inst (dragon and tiger list institution details)
6000 points permission tools:
- get_eastmoney_concept_board (Eastmoney concept sector)
- get_eastmoney_concept_daily (Eastmoney concept sector market)
- get_eastmoney_concept_member (Eastmoney concept sector constituent)
Separate permission tools (need to apply separately):
- get_stock_min (A-share real-time minute market)
- get_stock_rt_k (Shanghai and Shenzhen, Beijing real-time daily line)
- get_fut_min (futures real-time minute market)
- scan_announcement_signals (announcement signal scanning)
## Tool Statistics
Total tools: 52
Alpha strategy analysis: 6
Stock market tools: 22
Index market tools: 4
Foreign exchange tools: 1
Futures tools: 5
Financial statement tools: 2
Concept sector tools: 8
Volume anomaly analysis: 1
Cache management tools: 1
## Scripts for Statistics
python g:\AICode\tocker-mcp\tushare_MCP\scripts\realtime_collector.py
## Scripts for Sector Strength Statistics
python g:\AICode\tocker-mcp\tushare_MCP\scripts\sector_strength_collector.py
### analyze_sector_health:
New sector health analysis tool. It calculates trend slope (Slope) by linear regression of sector score in the past one hour and combines volume continuity and endogenous breadth (up ratio) to grade sector trend sustainability A/B/C.
### get_index_rt_k:
Based on rt_k API provided by you. Specially used to obtain real-time daily snapshot of index (e.g., 000001.SH Shanghai Index), convenient as relative strength benchmark.
### scan_realtime_strong_sectors:
Optimized real-time strength scanning logic. Now automatically capture full market (6-word head, 0-word head, 3-word head, BSE, etc.) and compare with yesterday's trading volume more accurately.
