股票分析MCP服务stock-scanner-mcp

发表于 2025-07-02 分类于各种折腾 Waline：阅读次数：本文字数： 3.9k 阅读时长 ≈ 4 分钟

stock-scanner-mcp 是对项目的 stock-scanner 的二次开发，向原作者致敬~

什么是 stock-scanner ？

stock-scanner 是一个专业的股票分析系统，提供全面的技术指标分析和投资建议。

什么是 stock-scanner-mcp ？

stock-scanner-mcp 是基于项目 stock-scanner 的二次开发，取消了前端页面和 nginx ，保留了原项目的核心 services 和 utils ，将其转换成了 MCP 服务。

前言

最近迷上了写代码，虽然老苏不是程序员，但是有了 AI 的加持，我也想看看，到底能做到什么程度？

上周基于一个 Python 库，搓了一个 MCP 服务。鉴于 Cursor 的试用期尚未结束，总觉得不再搞点事情，对不起我辛苦的注册。

之前老苏介绍过基于AI的股票分析系统Stock-Scanner ，就拿它试试，看能不能改造成 MCP 服务。此次改造的核心要求是：不得改动 services 和 utils 目录中的现有文件，因为它们是该项目的核心代码。

第一个上场的是 Cursor，但是直到试用期结束，虽然 MCP 已经能正常注册，但是调用工具还在不断报错；

第二个上场的是 Gemini CLI ，虽然一直用的 gemini-2.5-pro，但也没搞定。不得不说，在编程方面，Google 还是差点意思；

第三个上场的是 VS Code + Cline + Gemini CLI

需要安装特定的 Cline 版本

因为只有这个版本的 API Provider 才支持 Gemini CLI

虽然模型还是用的 gemini-2.5-flash，但专业的就是专业的，才几个回合就搞定了。而且还发现了新问题，但出于初衷的考虑，我拒绝了

因为这个问题在原版 Stock-Scanner 中也存在

既然是复刻，那 bug 也应该保留吧😜

代码放在了 https://github.com/wbsu2003/stock-scanner-mcp

安装

源码安装

如果不想借助服务器，可以在本机安装

关于 python 环境的安装，不在本文的范围，请自行搜索学习；

# 下载代码
git clone https://github.com/wbsu2003/stock-scanner-mcp.git

# 通过代理
git clone https://gh-proxy.com/github.com/wbsu2003/stock-scanner-mcp.git
  
# 进入目录  
cd stock-scanner-mcp

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

# 运行服务
python main.py

docker 安装

在群晖上以 Docker 方式安装。

在注册表中搜索 wbsu2003 ，下拉找到 wbsu2003/stock-scanner-mcp，版本选择 latest。

卷

在 docker 文件夹中，创建一个新文件夹 stock-scanner-mcp，并在其中建一个子文件夹 logs

文件夹	装载路径	说明
`docker/stock-scanner-mcp/logs`	`/app/utils/logs`	存放日志文件

端口

本地端口不冲突就行，不确定的话可以用命令查一下

1 2	# 查看端口占用 netstat -tunlp \| grep 端口号

本地端口	容器端口
`8060`	`8000`

环境

可变	值
`API_KEY`	您的 `API` 密钥
`API_URL`	您的 `API` 地址
`API_MODEL`	您的大语言模型

关于 API_URL 的处理规则，是和 Cherry Studio 一致的

上图截取自上游项目的说明： https://github.com/lanzhihong6/stock-scanner

以硅基流动为例

API_KEY：硅基流动的 API key，类似 sk-xxxxxxxxxxxxxx
API_URL：硅基流动的 API 地址，https://api.siliconflow.cn
API_MODEL：硅基流动中的大模型，例如 deepseek-ai/DeepSeek-V3

目前硅基流动（SiliconFlow），注册就送 2000 万 Tokens，虽然不是免费，但也够用一阵子的

注册地址：

https://cloud.siliconflow.cn/i/NkUiXVhQ

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 stock-scanner-mcp 和 子目录
mkdir -p /volume1/docker/stock-scanner-mcp/logs

# 进入 stock-scanner-mcp 目录
cd /volume1/docker/stock-scanner-mcp

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name stock-scanner-mcp \
   -p 8060:8000 \
   -v $(pwd)/logs:/app/utils/logs \
   -e API_KEY="您的API密钥" \
   -e API_URL="您的API地址" \
   -e API_MODEL="您的大语言模型" \
   wbsu2003/stock-scanner-mcp

# 示例（硅基流动）
docker run -d \
   --restart unless-stopped \
   --name stock-scanner-mcp \
   -p 8060:8000 \
   -v $(pwd)/logs:/app/utils/logs \
   -e API_KEY="sk-xxxxxxxxxxxxxx" \
   -e API_URL="https://api.siliconflow.cn" \
   -e API_MODEL="deepseek-ai/DeepSeek-V3" \
   wbsu2003/stock-scanner-mcp

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: '3'

services:
  stock-scanner-mcp:
    image: wbsu2003/stock-scanner-mcp
    container_name: stock-scanner-mcp
    restart: unless-stopped
    ports:
      - "8060:8000"
    volumes:
      - ./logs:/app/utils/logs
    environment:
      API_KEY: "sk-xxxxxxxxxxxxxx"
      API_URL: "https://api.siliconflow.cn"
      API_MODEL: "deepseek-ai/DeepSeek-V3"

然后执行下面的命令

# 新建文件夹 stock-scanner-mcp 和 子目录
mkdir -p /volume1/docker/stock-scanner-mcp/logs

# 进入 stock-scanner-mcp 目录
cd /volume1/docker/stock-scanner-mcp

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

因为原项目 stock-scanner 是带 web 界面的，所以老苏改的 MCP 服务就没带，如果有这方面的需要，可以去安装原版的镜像，安装方法看看老苏之前的写的基于AI的股票分析系统Stock-Scanner

在浏览器中输入 http://群晖IP:8060/mcp

输入 http://群晖IP:8060/health ，可以看到服务运行是否正常

而输入 http://群晖IP:8060/docs，可以看到文档

Cherry Studio

名称：自己好识别就可以
类型：选择 SSE 协议
URL：http://群晖IP:8060/mcp，如果是安装在本机，可以用 http://localhost:8000/mcp

如果连接没问题，切换到工具可以看到内置的函数

新建一个助手，可以不需要有提示词，但是必须要启用 MCP 服务

开始测试，输入 分析一下 600795 怎么样

继续 ETF 510020

继续 LOF基金160637

如果要启用 AI 分析，需要强调一下 用 AI 分析 600795

通过提示词可以做成卡片

即便没有 claude 模型，也一样可以做成比较好看的卡片

当然有的话，效果可能会更好一些

注意事项

老苏不炒股，也不是程序员，纯粹是折腾着玩的，所以不管原来的版本有多专业，这个二开的版本不是，就当是个玩具吧

最后夸一下大善人 google， Gemini CLI确实很实用，而且免费额度高，如果不是用来写代码，可以考虑在 Warp 中开启 Gemini CLI

可以缓解 Warp 免费额度不足的问题（每个月只能使用 150 次，但能使用 Claude 4.0 sonnet）

最主要的是 Warp 字体比 Powershell 好看

参考文档

wbsu2003/stock-scanner-mcp: 这是一个基于 FastAPI-MCP 的股票分析服务，旨在通过 MCP 工具函数接口提供股票相关的综合数据和分析能力，包括价格、评分、技术报告和 AI 分析。
地址：https://github.com/wbsu2003/stock-scanner-mcp

lanzhihong6/stock-scanner: 开源量化分析
地址：https://github.com/lanzhihong6/stock-scanner