Skip to main content
Glama
erwanjun

tushare-mcp-server

by erwanjun
OverviewSchemaRelated ServersScoreDiscussions
Python

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.

Related MCP server: smart-financial-mcp

Prerequisites

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

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/erwanjun/tushare-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server