Skip to main content
Glama
erwanjun

tushare-mcp-server

by erwanjun
OverviewSchemaSourceRelated ServersDiscussionsAdmin
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: a-share-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 deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • smart-financial-mcp

    YUHAI0
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides AI assistants with real-time and historical Chinese stock, ETF, index, and futures data via Tushare Pro API, enabling natural language queries for financial analysis and market monitoring.
    5
    MIT

  • a-share-mcp

    kissjerryfan
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables users to query Chinese A-share stock data, including stock basics, historical prices, financial reports, and macroeconomic indicators.
    1
    MIT

  • AKShare MCP Server

    jadenmong
    A
    license
    B
    quality
    D
    maintenance
    Enables AI assistants to access comprehensive Chinese financial market data including stocks, funds, futures, and economic indicators via AKShare.
    5
    5
    MIT

  • mcp-eastmoney

    27dream
    A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to query real-time A-share stock data, including quotes, fund flows, sector flows, and K-line history, without needing an API key.
    5
    12
    MIT