FinQ4Cn MCP 服务器

一个专为定量分析设计的专用MCP服务器工具，FinQ4Cn-mcp-server旨在为中国A股市场提供便捷、免费且开源的金融数据访问。该项目基于akshare库构建，专注于中国A股市场，为用户提供全面的股票及相关金融产品的数据支持。特别适合从事定量分析的专业人士以及对中国国内股市感兴趣的用户，满足其对中国金融市场数据的需求。作为专为国内市场投资者设计的理想选择，FinQ4Cn-mcp-server提供完整的股票名称及代码获取、股价历史数据分析、财务概要数据查询、融资融券明细数据等核心功能。

未来计划

项目后续将逐步实现以下功能：

1. 丰富股票数据：增加更多股票的详细信息和数据支持。
2. 技术分析支持：提供常用的技术指标分析工具，如K线图绘制、移动平均线（MA）、相对强弱指数（RSI）等。
3. 风险预警系统：开发基于历史数据分析的风险评估模型。
4. 用户自定义策略：允许用户根据需求定制个性化交易策略。

功能模块

股票风险预警

• 获取股票名称及代码
• 查询股价历史数据
• 分析财务概要数据
• 查看融资融券明细数据

常见指标数据

• 最新财务新闻获取
• 个股相关新闻查询

回测系统

• 策略一：基于用户持有比例和止盈条件的历史数据分析回测结果。

项目结构

FinQ4Cn-MCP-Server/
├── README.md                 # 项目说明文档
├── LICENSE                  # 许可证文件
├── requirements.txt        # 依赖管理
├── app.py                   # 主程序入口
└── finq4cn/                # 核心功能模块
    ├── stocks_common_metrics.py   # 股票常见指标数据处理
    └── news_report.py              # 新闻数据获取模块

依赖项

• 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
   

使用说明

示例代码：

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)

许可证

本项目采用MIT许可证，详细内容请参阅LICENSE文件。

致谢

• 使用FastMCP构建
• 依赖akshare获取全面的金融数据支持
• 使用Pydantic进行数据验证