Tsrs MCP Server

A TuShare data service based on the MCP protocol, providing various stock market data query functions

Finance Research and data #Stock Data #Market Analysis #Fund Flow #Concept Themes .Rust

rating : 2.5 points

downloads : 12.3K

update time : 2025-04-29

Open Site

What is the TuShare MCP Data Server?

The TuShare MCP Data Server is an efficient data query tool built with the Rust language. By encapsulating the TuShare API, it provides users with rich stock market data. It supports multiple query tools and is suitable for investors, analysts, and anyone who needs real - time market data.

How to use the TuShare MCP Data Server?

Users can obtain the required data through simple command - line operations. Just set up the API Token and execute the relevant commands as instructed to quickly get the required information.

Applicable Scenarios

It is applicable to fields such as stock investment analysis, market trend research, and daily trading decision - making support.

Main Features

limit_step

Get stocks that have advanced in the number of consecutive daily limit up boards, supporting the specification of a date range and the number of consecutive limit up boards.

ths_hot

Get the hot list data of the Flush App, supporting daily queries.

kpl_list

Get the data of limit up and limit down boards, supporting the specification of a date range and label filtering.

kpl_concept

Get the list of opening concept themes on KaiPanLa, supporting daily queries.

moneyflow_ths

Get the individual stock fund flow data of Flush, supporting the specification of a stock code and a date range.

Advantages

High performance: Developed with the Rust language, it runs fast and stably.

Ease of use: It provides an intuitive command - line interface and detailed usage instructions.

Rich data sources: It integrates the TuShare API, covering a wide range of market data.

Flexibility: It supports multiple custom query options.

Limitations

Dependence on external API: You need to register a TuShare account and obtain a Token.

Data delay: Some data may have a certain time delay.

Requires a certain computer foundation: It is suitable for users with some programming experience.

How to Use

Installation and Configuration

Download and extract the released version, and set the TuShare API Token.

Start the Server

Run the server binary file to start listening for requests.

Execute Query Commands

Enter the corresponding query commands according to your needs.

Usage Examples

Case Title: Get Stocks that have Advanced in Consecutive Limit Up Boards

Query the stocks with 5 consecutive limit up boards from August 1st to August 31st, 2023.

Case Title: Get Individual Stock Fund Flow

Query the fund flow data of a certain stock on September 1st, 2023.

Frequently Asked Questions

How to obtain the TuShare API Token?

What should I do if the server fails to start normally?

What should I do if the query result is empty?

Related Resources

TuShare Official Website

TuShare API documentation and registration page.

GitHub Repository

Project source code and more detailed instructions.

ChatWise Configuration Example

How to integrate the TuShare MCP server in ChatWise.

🚀 tsrs-mcp-server

A TuShare data server based on the Model Context Protocol (MCP), offering a series of stock market data query interfaces.

🚀 Quick Start

This project is an MCP server implemented in Rust, encapsulating the TuShare API and providing multiple stock market data query tools.

✨ Features

The project offers the following MCP tools:

Tool Name	Function Description	Main Parameters	Return Data
limit_step	Retrieve stocks with consecutive daily limit-up board promotions	trade_date, start_date, end_date, nums	Stock codes, names, trading dates, consecutive limit-up board times
ths_hot	Obtain hot list data from the Flush App	trade_date	Stock information, rankings, popularity, concepts, etc.
kpl_list	Get limit-up and limit-down board data	tag, start_date, end_date	Detailed limit-up and limit-down information, trading data, etc.
kpl_concept	Retrieve the list of concept themes from KaiPanLa	trade_date	Theme codes, names, number of limit-up stocks, etc.
kpl_concept_cons	Get the constituent stocks of KaiPanLa concept themes	trade_date, ts_code	Detailed information of theme constituent stocks
limit_cpt_list	Obtain the concept sectors with the most daily limit-up stocks	trade_date, start_date, end_date	Sector codes, names, consecutive limit-up board data, etc.
moneyflow_ths	Retrieve the capital flow data of individual stocks from Flush	ts_code, trade_date, start_date, end_date	Detailed capital flow data
moneyflow_cnt_ths	Get the daily capital flow of concept sectors from Flush	trade_date, start_date, end_date	Sector capital flow data
stk_mins	Obtain A-share minute-level data	ts_code, freq, start_date, end_date	Minute-level trading data

📚 Documentation

Project Structure

The project consists of the following main components:

ts-derive: Provides procedural macro implementations for the TuShare API.
ts-model: Contains data models.
src: Implements the main program.

Environment Configuration

Before running the project, you need to set the TuShare API token:

Copy .env.example to .env.
Set your TuShare token in the .env file:

TUSHARE_TOKEN=your_token_here

Build

Prerequisites: Install Rust and Cargo.

cargo build --release

./target/release/tsrs-mcp-server

Run

You can find the compiled products for the corresponding platform in the release, such as tsrs-mcp-server-<tag>-aarch64-apple-darwin.tar.gz.

The running configuration is as shown in the following figure (only the configuration in Chatwise is shown):

Acknowledgments

Thanks to the following projects and libraries. In particular, poem-mcpserver provides great convenience for MCP development. Without it, the implementation of this project would not be so simple. Also, thanks to the TuShare API for providing the data interface. Finally, thanks to rust. Without procedural macros, the template implementation of this project would be extremely mechanical.