Finq4cn MCP Server

🚀 FinQ4Cn MCP 服務器

FinQ4Cn-mcp-server 是一個專為定量分析設計的專用 MCP 服務器工具。它基於akshare庫構建，專注於中國 A 股市場，能為用戶提供便捷、免費且開源的金融數據訪問。該項目適合從事定量分析的專業人士以及對中國國內股市感興趣的用戶，可滿足他們對中國金融市場數據的需求。其提供了完整的股票名稱及代碼獲取、股價歷史數據分析、財務概要數據查詢、融資融券明細數據等核心功能。

🚀 快速開始

依賴項安裝

本項目依賴以下庫：

• FastMCP：快速 MCP 協議支持。
• Pydantic：用於數據驗證和序列化。
• akshare：提供豐富的中國金融市場數據。

安裝命令如下：

pip install fastmcp pydantic akshare

設置步驟

1. 克隆倉庫：

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

2. 創建虛擬環境並安裝依賴：

   python -m venv env
   source env/bin/activate  # 在 Windows 中使用`env\Scripts\activate`
   pip install -r requirements.txt
   

3. 運行程序：

   python app.py
   

✨ 主要特性

功能模塊

股票風險預警

• 獲取股票名稱及代碼
• 查詢股價歷史數據
• 分析財務概要數據
• 查看融資融券明細數據

常見指標數據

• 最新財務新聞獲取
• 個股相關新聞查詢

回測系統

• 策略一：基於用戶持有比例和止盈條件的歷史數據分析回測結果。

未來計劃

項目後續將逐步實現以下功能：

1. 豐富股票數據：增加更多股票的詳細信息和數據支持。
2. 技術分析支持：提供常用的技術指標分析工具，如 K 線圖繪製、移動平均線（MA）、相對強弱指數（RSI）等。
3. 風險預警系統：開發基於歷史數據分析的風險評估模型。
4. 用戶自定義策略：允許用戶根據需求定製個性化交易策略。

📦 安裝指南

依賴項安裝

pip install fastmcp pydantic akshare

克隆與環境搭建

git clone https://github.com/your-repository-url/FinQ4Cn-MCP-Server.git
cd FinQ4Cn-MCP-Server
python -m venv env
source env/bin/activate  # 在 Windows 中使用`env\Scripts\activate`
pip install -r requirements.txt

運行程序

python app.py

💻 使用示例

基礎用法

if __name__ == "__main__":
    from finq4cn.stocks_common_metrics import StocksCommonMetrics
    
    # 創建 StocksCommonMetrics 實例
    stockutils = StocksCommonMetrics()
    
    # 獲取股票名稱及股票代碼
    stock_codes = stockutils.get_stock_code(name="華泰證券")
    
    if stock_codes:
        for item in stock_codes:
            stock_code = item['stock_code']
            print(f"處理股票代碼：{stock_code}")
            
            # 獲取股價歷史數據
            historical_data = stockutils.get_historical_stockprice_data(
                stock_code=stock_code, 
                start_date="20230101", 
                end_date="20231001"
            )
            print("股價歷史數據：", historical_data)
            
            # 獲取財務概要數據
            financial_summary = stockutils.get_stock_financial_abstract(
                stock_code=stock_code, 
                indicator='按報告期'
            )
            print("財務概要數據：", financial_summary)
            
            # 獲取融資融券明細數據
            margin_detail = stockutils.get_stock_margin_detail(
                stock_code=stock_code, 
                start_date="20230102", 
                end_date="20230110"
            )
            print("融資融券明細數據：", margin_detail)

📚 詳細文檔

項目結構

FinQ4Cn-MCP-Server/
├── README.md                 # 項目說明文檔
├── LICENSE                  # 許可證文件
├── requirements.txt        # 依賴管理
├── app.py                   # 主程序入口
└── finq4cn/                # 核心功能模塊
    ├── stocks_common_metrics.py   # 股票常見指標數據處理
    └── news_report.py              # 新聞數據獲取模塊

📄 許可證

本項目採用 MIT 許可證，詳細內容請參閱LICENSE文件。

致謝

• 使用FastMCP構建
• 依賴akshare獲取全面的金融數據支持
• 使用Pydantic進行數據驗證