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:

1. .env file (recommended) — create .env in the project root:

   TUSHARE_TOKEN=your_token_here

2. Environment variable — export TUSHARE_TOKEN=your_token
3. 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