China Stock MCP Server

🚀 China Stock MCP Server

The China Stock MCP Server is a Multi-Call Protocol (MCP) server that offers comprehensive access to China's stock market data through a unified API. It leverages the AKShare library to obtain real-time and historical data from various Chinese stock exchanges, such as the Shanghai Stock Exchange (SSE), Shenzhen Stock Exchange (SZSE), and Beijing Stock Exchange (BSE).

✨ Features

• Comprehensive Data Coverage: Access A-shares, B-shares, indices, ETFs, etc.
• Real-time Market Data: Latest quotes, bid-ask spreads, and market depth.
• Historical Data: Historical price data at daily, minute, and tick levels.
• Fundamental Data: Company information, financial reports, and dividend history.
• Market Intelligence: Industry analysis, concept sectors, and institutional holdings.
• Technical Indicators: Various technical analysis indicators and signals.

📦 Installation

# Clone the repository
git clone https://github.com/yourusername/china-stock-mcp.git
cd china-stock-mcp/china-stock-mcp-server

# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate  # For Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

💻 Usage Examples

Basic Usage

# Start the MCP server
python server.py

📚 Documentation

The server exposes numerous endpoints for accessing different types of stock market data. Each function has detailed parameter descriptions and return value formats. Some key functions include:

• stock_zh_a_spot_em(): Get real-time market data for A-shares.
• stock_zh_a_daily(symbol, start_date, end_date, adjust): Get historical daily data for a specific stock.
• stock_individual_info_em(symbol): Get detailed information about a specific stock.
• stock_financial_analysis_indicator(symbol): Get financial analysis indicators for a specific stock.

🔧 Technical Details

Dependencies

• AKShare: A Chinese financial data interface package.
• FastMCP: A multi-call protocol server framework.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.