Tushare MCP

🚀 Tushare MCP Server

An intelligent stock data assistant based on the Model Context Protocol (MCP)

🚀 Quick Start

The Tushare MCP Server is an intelligent stock data assistant based on the Model Context Protocol (MCP). It provides a variety of stock - related query and analysis functions, enabling users to interact with AI assistants such as Claude to obtain stock information.

✨ Features

1. Basic Stock Information Query

• Support precise query by stock code (e.g., 000001.SZ).
• Support fuzzy query by stock name (e.g., Ping An Bank).
• Returned information includes:
  • Stock code and name.
  • Industry and region of the stock.
  • Listing date.
  • Market type.
  • Trading status.

2. Intelligent Stock Search

• Support fuzzy keyword search.
• Match both stock codes and names simultaneously.
• Support industry keyword search (e.g., "New Energy", "Technology").
• Return a list of stocks with the highest matching degree.

3. Financial Statement Analysis

• Support querying the income statement data of listed companies.
• Flexible time - range query (annual reports, quarterly reports, semi - annual reports).
• Support multiple statement types (consolidated statements, parent company statements, etc.).
• Key indicators at a glance:
  • Earnings per share.
  • Operating income and cost.
  • Period expenses.
  • Profit indicators.
• Support historical data comparative analysis.

4. Secure Token Management

• Interactive Token configuration process.
• Local secure storage (encrypted storage).
• Automatic verification of Token validity.
• Regular Token status check.

💻 Usage Examples

Investment Research

"Find all stocks related to new energy."
"Query the basic information of BYD."
"Get the income statement of Ping An Bank in 2023."

Financial Analysis

"View the latest consolidated statement of Tencent Holdings."
"Compare the profit changes of Alibaba in the past three years."
"Analyze the quarterly profit trend of Xiaomi Group."

Industry Analysis

"List all stocks in the pharmaceutical industry."
"Find technology companies in Shenzhen."

Statement Query

"Query the income statement of Ping An Bank in the first quarter of 2023."
"Get the parent company statement of BYD."
"View the annual income statements of Kweichow Moutai in the past 5 years."

🔧 Technical Details

• Based on the MCP protocol, support natural dialogue with AI assistants such as Claude.
• Real - time connection to the Tushare Pro data source.
• Intelligent error handling and prompts.
• Support concurrent request processing.
• Data caching optimization.

📦 Installation

Environment Requirements

• Python 3.8+
• Tushare Pro account and API Token

Quick Start

1. Install the package

git clone https://github.com/zhewenzhang/tushare_MCP.git
cd tushare_MCP
pip install -r requirements.txt

2. Start the service

python server.py

3. Install in Claude

mcp install server.py

🔑 First - time Configuration

1. Get the Token
   • Visit Tushare Token page.
   • Log in to get the API Token.
2. Configure the Token

   Tell Claude: Please help me configure the Tushare token.
   

3. Verify the Configuration

   Tell Claude: Please verify whether the Tushare token is valid.
   

🤝 Contribution Guidelines

Welcome to submit Issues and Pull Requests!

📄 License

MIT License - See the LICENSE file for details.