Finq4cn MCP Server

🚀 FinQ4Cn MCP Server

FinQ4Cn-mcp-server is a dedicated MCP server tool designed for quantitative analysis, aiming to provide convenient, free, and open-source financial data access for the Chinese A-share market. Built on the akshare library, this project focuses on the Chinese A-share market, offering users comprehensive data support for stocks and related financial products. It is particularly suitable for professionals engaged in quantitative analysis and users interested in the Chinese domestic stock market, meeting their needs for Chinese financial market data. As an ideal choice for domestic market investors, FinQ4Cn-mcp-server provides core functions such as obtaining complete stock names and codes, analyzing historical stock price data, querying financial summary data, and accessing margin trading detailed data.

🚀 Quick Start

Future Plans

The project will gradually implement the following functions in the future:

1. Enrich Stock Data: Add more detailed information and data support for more stocks.
2. Technical Analysis Support: Provide common technical indicator analysis tools, such as K-line chart drawing, Moving Average (MA), Relative Strength Index (RSI), etc.
3. Risk Warning System: Develop a risk assessment model based on historical data analysis.
4. User-defined Strategies: Allow users to customize personalized trading strategies according to their needs.

Features

Stock Risk Warning

• Obtain stock names and codes.
• Query historical stock price data.
• Analyze financial summary data.
• View margin trading detailed data.

Common Indicator Data

• Get the latest financial news.
• Query news related to individual stocks.

Backtesting System

• Strategy 1: Backtest results based on historical data analysis of users' holding ratios and profit-taking conditions.

Project Structure

FinQ4Cn-MCP-Server/
├── README.md                 # Project description document
├── LICENSE                  # License file
├── requirements.txt        # Dependency management
├── app.py                   # Main program entry
└── finq4cn/                # Core function module
    ├── stocks_common_metrics.py   # Stock common indicator data processing
    └── news_report.py              # News data acquisition module

Installation

• FastMCP: Support for the fast MCP protocol.
• Pydantic: Used for data validation and serialization.
• akshare: Provides rich data on the Chinese financial market.

Installation command:

pip install fastmcp pydantic akshare

Setup Steps

1. Clone the repository:

   git clone https://github.com/your-repository-url/FinQ4Cn-MCP-Server.git
   cd FinQ4Cn-MCP-Server
   

2. Create a virtual environment and install dependencies:

   python -m venv env
   source env/bin/activate  # Use `env\Scripts\activate` on Windows
   pip install -r requirements.txt
   

3. Run the program:

   python app.py
   

Usage Examples

Basic Usage

if __name__ == "__main__":
    from finq4cn.stocks_common_metrics import StocksCommonMetrics
    
    # Create a StocksCommonMetrics instance
    stockutils = StocksCommonMetrics()
    
    # Get stock names and codes
    stock_codes = stockutils.get_stock_code(name="华泰证券")
    
    if stock_codes:
        for item in stock_codes:
            stock_code = item['stock_code']
            print(f"Processing stock code: {stock_code}")
            
            # Get historical stock price data
            historical_data = stockutils.get_historical_stockprice_data(
                stock_code=stock_code, 
                start_date="20230101", 
                end_date="20231001"
            )
            print("Historical stock price data: ", historical_data)
            
            # Get financial summary data
            financial_summary = stockutils.get_stock_financial_abstract(
                stock_code=stock_code, 
                indicator='按报告期'
            )
            print("Financial summary data: ", financial_summary)
            
            # Get margin trading detailed data
            margin_detail = stockutils.get_stock_margin_detail(
                stock_code=stock_code, 
                start_date="20230102", 
                end_date="20230110"
            )
            print("Margin trading detailed data: ", margin_detail)

License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.

Acknowledgments

• Built with FastMCP.
• Relies on akshare for comprehensive financial data support.
• Uses Pydantic for data validation.