📈 stock-scanner-mcp 技能介绍

技能简介

stock-scanner-mcp 是基于 FastAPI-MCP 的股票分析服务，将股票数据查询、技术分析、评分和 AI 分析能力封装为标准 MCP 工具函数，供 AI 助手直接调用。项目支持 A 股、港股、美股及基金数据分析，基于 Python 异步框架构建，支持 SSE 协议流式响应。在 GitHub 收获 244 颗星标，是一个专注于金融数据分析的实用型 MCP 服务器。

核心能力

• 股票综合分析：调用 /stock_analyzer 接口，返回价格、评分、技术分析、AI 分析等综合信息，支持流式响应
• 实时价格查询：调用 /stock_price 获取股票最新价格、涨跌幅等基本行情数据
• 技术指标分析：调用 /stock_technical_analysis 获取 MA 趋势、RSI、MACD 信号、布林带等常用技术指标
• 股票评分系统：调用 /stock_score 获取综合评分和投资建议
• AI 智能分析：调用 /stock_ai_analysis 利用大语言模型对股票进行深度分析，提供趋势、风险、目标价位等综合判断
• 多市场覆盖：支持A股、港股、美股及基金数据分析
• 流式 SSE 响应：支持服务端发送事件流，实时推送分析进度和结果

安装配置

环境要求

• Python 3.x
• FastAPI、FastApiMCP、MCP 框架
• akshare（股票数据获取）
• pandas、httpx 等数据处理依赖

方式一：Git 克隆安装

# 克隆仓库
git clone https://github.com/wbsu2003/stock-scanner-mcp.git
cd stock-scanner-mcp

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 填写 API 密钥等信息

# 启动服务
python main.py
# 或使用 uvicorn
uvicorn main:app --host 0.0.0.0 --port 8000 --reload

方式二：Docker 部署

# 构建镜像
docker build -t stock-scanner-mcp .

# 运行容器
docker run -d -p 8000:8000 --name stock-scanner-mcp-app 
  -e API_KEY="您的API密钥" 
  -e API_URL="您的API地址" 
  -e API_MODEL="您的大语言模型" 
  stock-scanner-mcp

使用步骤

1. 部署服务：通过 Git 克隆或 Docker 方式完成部署
2. 配置 API：在 .env 文件中填写股票数据 API 密钥和相关配置
3. 启动服务：运行 python main.py 或通过 Docker 启动容器
4. 注册 MCP 工具：将服务注册到 MCP 客户端（Claude Desktop、Cursor 等）
5. 自然语言查询：向 AI 助手提问如"帮我分析一下贵州茅台的股票"
6. 获取分析结果：AI 助手调用 analyze_stock 等工具，返回综合分析报告

适用场景

• 投资研究辅助：快速获取股票技术分析和 AI 评级，辅助投资决策
• 量化交易系统：为量化交易机器人提供实时股票数据接口
• 金融客服机器人：在 AI 客服中集成股票查询能力，自动回答股票分析问题
• 投资组合监控：定期调用分析接口，监控持仓股票动态
• 金融教育平台：在金融教育产品中嵌入实时股票分析演示功能
• 数据分析报告：批量获取多只股票的技术指标，生成分析报告

适用人群

• 需要在 AI 助手中集成股票分析能力的投资者和分析师
• 建设量化交易系统或金融数据平台的开发者
• 提供 AI 投资建议服务的金融科技团队
• 研究 MCP 协议在金融领域应用的技术学习者

工作原理

stock-scanner-mcp 基于 FastAPI 和 FastApiMCP 框架构建，核心架构分为三层。接口层（API Routes）提供 RESTful 端点，包括 /stock_analyzer（综合分析）、/stock_price（价格）、/stock_technical_analysis（技术分析）、/stock_score（评分）、/stock_ai_analysis（AI 分析）。FastApiMCP 层将这些 API 自动注册为 MCP 工具函数，通过 /mcp 端点供 AI 助手调用。数据层由 StockDataProvider 从数据源（akshare）获取原始数据，经 TechnicalIndicator 计算技术指标，由 StockScorer 给出评分，最后经 AIAnalyzer 调用大语言模型生成深度分析报告。所有接口均支持 SSE 流式响应，可实时推送分析进度。

官方链接

• GitHub：https://github.com/wbsu2003/stock-scanner-mcp
• 博客介绍：https://laosu.tech/2025/07/02/股票分析MCP服务stock-scanner-mcp
• 公众号文章：https://mp.weixin.qq.com/s/x60X3th9Doqm891_sUia1A