A Model Context Protocol (MCP) server for Tushare, providing Chinese financial market data.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"tushare-mcp-server","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Tushare MCP Server [English](./README.md) | [中文](./README_zh.md) This project is a Model Context Protocol (MCP) server based on the [Tushare](https://tushare.pro/) data interface. It provides rich and comprehensive financial market data for mainland China, designed to be used with AI assistants. ## 🌟 Features - **Stock Data**: Access to basic stock information, daily/weekly/monthly quotes, and historical data. - **Market Data**: Includes Top List (Longhubang), Margin Trading, Block Trades, and Money Flow data. - **Financial Data**: Retrieve financial statements and key indicators for listed companies. - **Index Data**: Get quotes and historical data for major market indices. - **Fund & ETF Data**: Access to ETF quotes, fund NAV, holdings, and ratings. - **Bond Data**: Provides basic information and market data for bonds and convertible bonds. - **Macroeconomics**: Offers data on GDP, CPI, interest rates, exchange rates, PMI, and money supply. - **Smart Search**: Search for stocks by name or code. - **High Performance**: Built with asynchronous processing to support efficient queries. ## 📦 Installation 1. Clone the repository: ```bash git clone https://github.com/your-username/tushare_mcp.git cd tushare_mcp ``` 2. Install the required dependencies: ```bash pip install -r requirements.txt ``` ## ⚙️ Configuration To use this server, you need to provide a Tushare API Token. You can get a free token by registering on the [Tushare Pro website](https://tushare.pro/). There are two ways to configure your token: #### Method 1: Environment Variable (Recommended) This is the most secure and flexible method. The server is designed to automatically read the token from an environment variable named `TUSHARE_TOKEN`. - **On macOS/Linux:** ```bash export TUSHARE_TOKEN="your_tushare_token_here" ``` To make this setting permanent, add the line to your shell's profile file (e.g., `~/.bash_profile`, `~/.zshrc`). - **On…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.