StockReport

StockReport MCP Server provides a flexible, multi-market stock data service that you can query via MCP clients. It consolidates stock information, historical data, financials, macroeconomic data, and market overviews from multiple data sources, enabling you to answer questions about the stock market across the A-share, Hong Kong, and U.S. markets.

How to use

You connect to StockReport MCP Server using an MCP client. The server can run locally and expose data through standard MCP endpoints, allowing you to request stock basics, historical data, financial indicators, macro data, market summaries, and more. Choose an appropriate data source mode (Hybrid is recommended) to automatically route queries to the best available source for each market.

How to install

Prerequisites you need to meet before starting include Python 3.10 or newer and the uv package manager to install dependencies. Ensure you have a working Python environment and that you can run Python scripts from your command line.

Step-by-step commands to set up and run the MCP server locally:

# 1. Create a virtual environment (only create, do not install packages yet)
uv venv
# 2. Activate the virtual environment
# Windows
.venv\Scripts\activate
# macOS/Linux
# source .venv/bin/activate
# 3. Install all dependencies within the active environment
uv sync```To start the MCP server using the standard, fully-featured entry point, run:```bash
python mcp_server.py```If you prefer the simplified server, you can run:```bash
python simple_mcp_server.py```For interactive startup, you can also launch via the start script:```bash
python start_server.py```On Windows, you can alternatively start the batch script:```bash
start_server.bat```
These commands will bring up the MCP server, ready to accept client connections from MCP-enabled tools and editors.

## Configuration and usage notes

Data sources can be selected at startup. The Hybrid mode combines Baostock for A-share data and AkShare for Hong Kong and U.S. markets, with macroeconomic data also sourced via Baostock. You can switch to Baostock-only or AkShare-only if you prefer a single-source configuration.

The server supports multiple MCP clients, including Trae AI, Claude Desktop, and Cherry Studio. You configure your client to start the MCP server process locally and connect to it via the MCP protocol.

## Notes on data and scheduling

Be aware that some data may be time-sensitive. For example, certain daily data updates occur at specific times, so querying data for the current trading day before those updates complete may return incomplete results. Plan queries accordingly if you need the latest numbers.

## Troubleshooting and tips

If you encounter issues starting the MCP server, verify that the virtual environment is activated and dependencies are installed. Use the full Python command and script name exactly as shown above. If a UI-based client does not connect, confirm the client is configured to use the correct working directory and that the MCP process is running in the background.

## Available tools

### get\_historical\_k\_data

Fetch historical K-line data for a specific stock or market, returning open, high, low, close, and volume values over a chosen time interval.

### get\_stock\_basic\_info

Retrieve basic information about a stock, including symbol, name, exchange, and listing status.

### get\_dividend\_data

Obtain dividend history and related corporate actions for a stock.

### get\_adjust\_factor\_data

Get stock adjustment factors used for price adjustments across time.

### get\_profit\_data

Access profit-related financial data from income statements.

### get\_operation\_data

Retrieve operational metrics and performance indicators from financial reports.

### get\_growth\_data

Obtain growth-related metrics such as revenue growth and earnings growth.

### get\_balance\_data

Fetch balance sheet data including assets, liabilities, and equity.

### get\_cash\_flow\_data

Retrieve cash flow statements and related indicators.

### get\_dupont\_data

Provide concessionary DuPont analysis metrics for profitability and efficiency.

### get\_trade\_dates

Get trading dates for a given market or instrument set.

### get\_all\_stock

List all stocks meeting certain criteria or in a given market.

### get\_stock\_industry

Fetch industry classification data for stocks.

### get\_sz50\_stocks

Return constituent stocks of the SZ50 index.

### get\_hs300\_stocks

Return constituent stocks of the HS300 index.

### get\_zz500\_stocks

Return constituent stocks of the ZZ500 index.

### get\_deposit\_rate\_data

Obtain deposit rate data from macroeconomic sources.

### get\_loan\_rate\_data

Obtain loan rate data from macroeconomic sources.

### get\_required\_reserve\_ratio\_data

Get required reserve ratio figures for macroeconomic context.

### get\_money\_supply\_data\_month

Provide money supply data on a monthly basis.

### get\_money\_supply\_data\_year

Provide money supply data on a yearly basis.

### get\_shibor\_data

Fetch SHIBOR rate data for interbank lending.

### get\_latest\_trading\_date

Retrieve the latest trading date for market schedules.

### get\_market\_analysis\_timeframe

Analyze market data over a specified timeframe.

### get\_stock\_analysis

Provide stock-specific analytical insights and indicators.

### get\_hk\_historical\_k\_data

Fetch historical K-line data for Hong Kong stocks.

### get\_hk\_stock\_basic\_info

Retrieve basic information for Hong Kong stocks.

### get\_hk\_stock\_realtime\_data

Access real-time data for Hong Kong stocks.

### get\_popular\_hk\_stocks

List popular Hong Kong stock symbols based on activity.

### search\_hk\_stocks

Search for Hong Kong stocks by keyword or criteria.

### get\_hk\_dividend\_data

Obtain Hong Kong stock dividend data.

### get\_hk\_profit\_data

Access Hong Kong stock profit data.

### get\_hk\_operation\_data

Retrieve Hong Kong stock operational metrics.

### get\_hk\_growth\_data

Obtain growth metrics for Hong Kong stocks.

### get\_hk\_balance\_data

Fetch Hong Kong stock balance sheet data.

### get\_hk\_cash\_flow\_data

Retrieve Hong Kong stock cash flow data.

### get\_hk\_dupont\_data

Provide DuPont analysis for Hong Kong stocks.

### get\_hk\_stock\_analysis

Compute analysis metrics for Hong Kong stocks.

### get\_us\_historical\_k\_data

Fetch historical K-line data for U.S. stocks.

### get\_us\_stock\_basic\_info

Retrieve basic information for U.S. stocks.

### get\_us\_stock\_realtime\_data

Access real-time data for U.S. stocks.

### get\_popular\_us\_stocks

List popular U.S. stock symbols based on activity.

### search\_us\_stocks

Search for U.S. stocks by keyword or criteria.

### get\_us\_stock\_analysis

Provide analysis metrics for U.S. stocks.