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进行数据验证