tushare-mcp-server

中文文档 | English

A Model Context Protocol (MCP) server for Tushare Pro financial data API. Provides AI assistants (GitHub Copilot, Claude, etc.) with direct access to comprehensive Chinese financial market data — covering A-shares, indices, funds, futures, options, bonds, forex, HK/US stocks, and macroeconomic indicators.

Features

Universal Query — tushare_query calls any of the 173 Tushare Pro APIs
15 Convenience Tools — Pre-built tools for stocks, indices, financials, funds, and more
Built-in Documentation — get_api_doc / search_api_docs for API parameter lookup
Categorized Index — 173 APIs organized into 18 categories

Data Coverage

Category	#	Examples
A-Shares	37	stock_basic, daily, weekly, monthly, daily_basic, adj_factor, pro_bar
Financials	9	income, balancesheet, cashflow, fina_indicator, forecast
Market Reference	23	margin, top_list, block_trade, hsgt_top10, pledge_stat
Indices	13	index_basic, index_daily, index_weight, sw_daily, ci_daily
Money Flow	8	moneyflow, moneyflow_hsgt, moneyflow_ind_ths
Funds	14	fund_basic, fund_nav, fund_daily, etf_basic, fund_portfolio
Futures	8	fut_basic, fut_daily, fut_holding, fut_mapping
Options	3	opt_basic, opt_daily, opt_mins
Bonds / CB	9	cb_basic, cb_daily, cb_issue, repo_daily, yc_cb
HK Stocks	9	hk_basic, hk_daily, hk_income, hk_balancesheet
US Stocks	8	us_basic, us_daily, us_income, us_balancesheet
Macro Economy	14	shibor, cn_gdp, cn_cpi, cn_ppi, cn_pmi, libor
Sector / Concept	5	ths_index, ths_daily, dc_index, dc_member
Others	13	fx_daily, sge_daily, news, trade_cal, etc.

Prerequisites

Python 3.10+
A Tushare Pro account and API token

Quick Start

Install via npx (recommended)

No installation needed — just configure your MCP client:

{
  "servers": {
    "tushare": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tushare-mcp-server"],
      "env": { "TUSHARE_TOKEN": "your_token_here" }
    }
  }
}

Install from source

git clone https://github.com/erwanjun/tushare-mcp-server.git
cd tushare-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip install mcp httpx

Configuration

Tushare Token

Set your token via any of these methods:

.env file (recommended) — create .env in the project root:
```
TUSHARE_TOKEN=your_token_here
```
Environment variable — export TUSHARE_TOKEN=your_token
MCP client config — pass via the env field (see examples below)

VS Code (GitHub Copilot)

.vscode/mcp.json:

{
  "servers": {
    "tushare": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tushare-mcp-server"],
      "env": { "TUSHARE_TOKEN": "your_token_here" }
    }
  }
}

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "tushare": {
      "command": "npx",
      "args": ["-y", "tushare-mcp-server"],
      "env": { "TUSHARE_TOKEN": "your_token_here" }
    }
  }
}

Tools

Tool	Description
`tushare_query`	Universal query — call any Tushare Pro API
`get_stock_list`	A-share stock list
`get_trade_calendar`	Trading calendar
`get_daily_bars`	Daily OHLCV (unadjusted)
`get_daily_basic`	Daily indicators: PE, PB, market cap, turnover
`get_income`	Income statement
`get_balancesheet`	Balance sheet
`get_cashflow`	Cash flow statement
`get_fina_indicator`	Financial indicators (ROE, ROA, margins)
`get_index_daily`	Index daily bars
`get_moneyflow`	Stock money flow
`get_concept`	Concept / sector classification
`get_concept_detail`	Concept constituents
`get_fund_basic`	Fund list
`get_fund_nav`	Fund NAV
`get_shibor`	Shibor interest rates
`get_api_doc`	Full API documentation by endpoint name
`search_api_docs`	Search API docs by keyword

Development

# Re-crawl Tushare documentation
python crawl_docs.py

# Rebuild API index
python build_index.py

License

MIT

tushare-mcp-server

tushare-mcp-server

Features

Data Coverage

Prerequisites

Quick Start

Install via npx (recommended)

Install from source

Configuration

Tushare Token

VS Code (GitHub Copilot)

Claude Desktop

Tools

Development

License

Latest Blog Posts

MCP directory API