go-stock-mcp
by WJS-WEB
README.md
# go-stock MCP Server for DeepSeek Harness
[](LICENSE)
[](go.mod)
[](https://modelcontextprotocol.io/)
[](https://github.com/WJS-WEB/go-stock-mcp/releases)
把 [go-stock](https://github.com/ArvinLovegood/go-stock) 的股票行情、K 线、
财务、资金流、新闻和研报能力，以只读 stdio MCP Server 的形式提供给
[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 及其他 MCP Client。
> 本项目只提供数据查询和研究辅助，不构成任何投资建议。行情和第三方接口
> 可能存在延迟、缺失或不可用情况，请勿将返回结果直接用于自动实盘交易。
## 主要特性
- 复用 go-stock 已有数据工具，不重复实现行情接口。
- SQLite 数据库以 `mode=ro` 打开，不执行迁移和后台清理。
- stdout 仅用于 MCP JSON-RPC，所有日志写入 stderr。
- 内置 DeepSeek Harness Bundle，可从 GitHub 直接安装。
- GitHub Releases 提供多平台二进制文件和 SHA-256 校验和。
- 第一版只开放 14 个经过筛选的只读工具。
## MCP 工具
| 工具 | 说明 |
| --- | --- |
| `search_stock` | 按股票名称、代码或拼音查询股票与指数 |
| `search_stock_news` | 按关键词查询市场新闻 |
| `list_industries` | 查询行业和板块代码 |
| `get_stock_info` | 获取股票实时行情和基本信息 |
| `get_stock_kline` | 获取日 K 线数据 |
| `get_stock_minute_data` | 获取当日分钟级行情 |
| `get_stock_financial_info` | 获取股票财务信息 |
| `get_stock_money_data` | 获取股票资金流排名 |
| `get_market_data` | 获取指数、涨跌分布和市场概览 |
| `get_industry_money_rank` | 获取行业资金流排名 |
| `get_fund_info` | 获取基金净值、涨跌幅和评级 |
| `get_invest_calendar` | 获取财报、股东大会、IPO 等投资日历 |
| `search_reports` | 搜索研究报告、评级和目标价 |
| `is_trading_day` | 判断指定日期是否为 A 股交易日 |
在 DeepSeek Harness 中，工具名称会带上命名空间，例如：
```text
mcp__go-stock__get_stock_info
mcp__go-stock__get_stock_kline
```
## 安装前准备
公开仓库不会上传任何用户数据库、API Key、Cookie 或 Token。使用前需要：
1. 安装 DeepSeek Harness。
2. 从 [Releases](https://github.com/WJS-WEB/go-stock-mcp/releases) 下载对应平台的 `go-stock-mcp`。
3. 准备自己的 `stock.db`。可以安装并运行一次上游 go-stock，然后使用其 `data/stock.db`。
可执行文件名称：
| 平台 | Release 文件 |
| --- | --- |
| Windows x64 | `go-stock-mcp-windows-amd64.exe` |
| Linux x64 | `go-stock-mcp-linux-amd64` |
| macOS Apple Silicon | `go-stock-mcp-darwin-arm64` |
下载后请根据 Release 中的 `SHA256SUMS` 校验文件完整性。
## 使用 DeepSeek Harness 安装
### Windows PowerShell
```powershell
$env:GO_STOCK_MCP_COMMAND = 'C:\Tools\go-stock-mcp-windows-amd64.exe'
$env:GO_STOCK_DB_PATH = 'C:\path\to\go-stock\data\stock.db'
$env:GO_STOCK_ROOT = 'C:\path\to\go-stock'
dsh plugin --profile demo add github:WJS-WEB/go-stock-mcp
dsh --profile demo
```
### Linux / macOS
```bash
chmod +x "$HOME/.local/bin/go-stock-mcp"
export GO_STOCK_MCP_COMMAND="$HOME/.local/bin/go-stock-mcp"
export GO_STOCK_DB_PATH="$HOME/path/to/go-stock/data/stock.db"
export GO_STOCK_ROOT="$HOME/path/to/go-stock"
dsh plugin --profile demo add github:WJS-WEB/go-stock-mcp
dsh --profile demo
```
`dsh plugin add` 安装的是 Harness Bundle，不会自动下载本机平台的 Go
可执行文件，因此需要先完成上面的 Release 安装和环境变量配置。
## 提问示例
```text
请使用 go-stock 工具查询贵州茅台的股票代码和最新行情。
获取 600519 最近 30 个交易日的日 K 线，并总结价格趋势。
查询今天的市场涨跌分布和行业资金流排名。
搜索近期关于人工智能行业的研究报告。
```
## 在其他 MCP Client 中使用
任何支持 stdio MCP 的客户端都可以直接启动二进制文件。例如：
```json
{
"mcpServers": {
"go-stock": {
"command": "C:/Tools/go-stock-mcp-windows-amd64.exe",
"args": [],
"env": {
"GO_STOCK_DB_PATH": "C:/path/to/go-stock/data/stock.db"
}
}
}
}
```
## 从源码构建
需要 Go 1.26 或 `go.mod` 指定的兼容版本：
```bash
git clone https://github.com/WJS-WEB/go-stock-mcp.git
cd go-stock-mcp
go test ./cmd/go-stock-mcp
go build -trimpath -o build/go-stock-mcp ./cmd/go-stock-mcp
```
Windows 可以将输出文件改为：
```powershell
go build -trimpath -o build\go-stock-mcp.exe ./cmd/go-stock-mcp
```
## 故障排查
### `executable not found`
确认 `GO_STOCK_MCP_COMMAND` 是存在的绝对路径，或者将二进制文件加入 `PATH`。
### `database initialization failed`
确认 `GO_STOCK_DB_PATH` 指向真实的 `stock.db` 文件，并且当前用户有读取权限。
数据库不会随仓库或 Release 发布，因为它可能包含用户的关注列表、历史分析和本地配置。
### 直接运行后没有交互界面
这是正常现象。stdio MCP Server 需要由 Harness、MCP Inspector 或其他 MCP
Client 通过 stdin 发送 JSON-RPC 请求，不是普通交互式命令行程序。
### 部分行情工具返回失败
部分工具依赖第三方公开数据接口，可能受网络、频率限制、接口变更或地区限制影响。
## 安全边界
当前版本不开放以下高风险能力：
- 创建、修改或删除股票分组和概念；
- 写入交易记录、操作计划或提示词；
- 设置交易价格；
- 发送钉钉或飞书消息；
- 创建、更新或删除 MCP Server 配置。
## 项目来源与许可证
本项目基于 [ArvinLovegood/go-stock](https://github.com/ArvinLovegood/go-stock)
开发，并保留原项目的 GPL-3.0 许可证。MCP-Go 和 DeepSeek Harness 分别遵循
其各自仓库中的许可证。
更详细的 MCP 构建和 Bundle 配置请参阅 [GO_STOCK_MCP.md](GO_STOCK_MCP.md)。
---
## 上游 go-stock 项目说明
# go-stock : 基于大语言模型的AI赋能股票分析工具
## 
[](https://github.com/ArvinLovegood/go-stock)
[](https://gitee.com/arvinlovegood_admin/go-stock)
[//]: # ([](https://gitcode.com/ArvinLovegood/go-stock))
[//]: # (## 💖 赞助商 (Sponsors))
[//]: # (### 🌟[Anspire开放平台](https://open.anspire.cn/?share_code=OMSTE9LW)，一Key同时启用全球热门大模型和联网搜索，无需科学上网，含免费额度)
[//]: # ([](https://open.anspire.cn/?share_code=OMSTE9LW))
[//]: # ()
[//]: # (<table>)
[//]: # (<tr>)
[//]: # (<td width="180">)
[//]: # (<a href="https://open.anspire.cn/?share_code=OMSTE9LW">)
[//]: # (<img src="./build/screenshot/anspire-logo.png" alt="Anspire" width="150">)
[//]: # (</a>)
[//]: # (</td>)
[//]: # (<td>)
[//]: # (感谢 <a href="https://open.anspire.cn/?share_code=OMSTE9LW">Anspire开放平台</a> 赞助了本项目！安思派AI服务平台(Anspire Open)是面向智能体时代的领先的基础设施提供商，现已上线AI联网搜索、AI模型服务、OpenClaw部署、无忧养虾服务。新用户立赠2500点，可体验平台下的任意产品。</td>)
[//]: # (</tr>)
[//]: # (<tr>)
[//]: # (<td width="180">)
[//]: # (<a href="https://www.compshare.cn/?ytag=GPU_YY_YX_git_go-stock">)
[//]: # (<img src="./build/screenshot/uclound.png" alt="UCloud" width="150">)
[//]: # (</a>)
[//]: # (</td>)
[//]: # (<td>)
[//]: # (感谢 <a href="https://www.compshare.cn/?ytag=GPU_YY_YX_git_go-stock">优云智算</a> 赞助了本项目！优云智算是UCloud旗下AI云平台，主打包月、按次的高性价比 国模Agent Plan套餐，同时提供官转稳定海外模型。支持接入 Claude Code、Codex 及 API 调用。支持企业高并发、7*24技术支持、自助开票。通过此链接注册的用户，可得免费5元平台体验金！ )
[//]: # (</td>)
[//]: # (</tr>)
[//]: # (</table>)
### 🌟公众号
### 📈 交流群
[//]: # (- QQ交流群2：[点击链接加入群聊【go-stock交流群2】：892666282](https://qm.qq.com/q/5mYiy6Yxh0))
- QQ交流群：[点击链接加入群聊【go-stock交流群】：491605333(定期清理，随缘入群)](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=0YQ8qD3exahsD4YLNhzQTWe5ssstWC89&authKey=usOMMRFtIQDC%2FYcatHYapcxQbJ7PwXPHK9OypTXWzNjAq%2FRVvQu9bj2lRgb%2BSZ3p&noverify=0&group_code=491605333)
- 硅基流动(siliconflow)，注册即送2000万Tokens，[注册链接](https://cloud.siliconflow.cn/i/foufCerk)
### ✨ 简介
- 本项目基于Wails和NaiveUI开发，结合AI大模型构建的股票分析工具。
- 目前已支持A股，港股，美股，未来计划加入基金，ETF等支持。
- 支持市场整体/个股情绪分析，K线技术指标分析等功能。
- 本项目仅供娱乐，不喜勿喷，AI分析股票结果仅供学习研究，投资有风险，请谨慎使用。
- 开发环境主要基于Windows10+，其他平台未测试或功能受限。
### 📃 使用手册
[go-stock使用手册](docs/go-stock使用手册.md)
### 📦 立即体验
[//]: # (- 安装版：[go-stock-amd64-installer.exe](https://github.com/ArvinLovegood/go-stock/releases))
- 绿色版：[go-stock-windows-amd64.exe](https://github.com/ArvinLovegood/go-stock/releases)
- MACOS绿色版：[go-stock-darwin-universal](https://github.com/ArvinLovegood/go-stock/releases)
[//]: # (- MACOS安装版：[go-stock-darwin-universal.pkg](https://github.com/ArvinLovegood/go-stock/releases))
### 💬 支持大模型/平台
| 模型 | 状态 | 备注 |
| --- | --- |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [OpenAI](https://platform.openai.com/) | ✅ | 可接入任何 OpenAI 接口格式模型 |
| [Ollama](https://ollama.com/) | ✅ | 本地大模型运行平台 |
| [LMStudio](https://lmstudio.ai/) | ✅ | 本地大模型运行平台 |
| [AnythingLLM](https://anythingllm.com/) | ✅ | 本地知识库 |
| [DeepSeek](https://www.deepseek.com/) | ✅ | deepseek-reasoner,deepseek-chat |
| [大模型聚合平台](https://cloud.siliconflow.cn/i/foufCerk) | ✅ | 如：[硅基流动](https://cloud.siliconflow.cn/i/foufCerk)，[火山方舟](https://www.volcengine.com/experience/ark?utm_term=202502dsinvite&ac=DSASUQY5&rc=IJSE43PZ) |
### <span style="color: #568DF4;">各位亲爱的朋友们，如果您对这个项目感兴趣，请先给我一个<i style="color: #EA2626;">star</i>吧，谢谢！</span>💕
[//]: # (- 优云智算（by UCloud）：万卡规模4090免费用10小时，新人注册另增50万tokens，海量热门源项目镜像一键部署，[注册链接](https://www.compshare.cn/image-community?ytag=GPU_YY-gh_gostock))
- 火山方舟：新用户每个模型注册即送50万tokens，[注册链接](https://www.volcengine.com/experience/ark?utm_term=202502dsinvite&ac=DSASUQY5&rc=IJSE43PZ)
[//]: # (- Tushare大数据开放社区,免费提供各类金融数据,助力行业和量化研究(注意：Tushare只需要120积分即可，注册完成个人资料补充即可得120积分！！！)，[注册链接](https://tushare.pro/register?reg=701944))
- 软件快速迭代开发中,请大家优先测试和使用最新发布的版本。
- 欢迎大家提出宝贵的建议，欢迎提issue,PR。当然更欢迎[赞助我](#都划到这了如果我的项目对您有帮助请赞助我吧)。💕
### 支持开源💕计划
| 赞助计划 | 赞助等级 | 权益说明 |
|:--------------------------------|----------------|:-------------------------------------------------------|
| 每月 0 RMB | vip0 | 🌟 全部功能,软件自动更新(从GitHub下载),自行解决github平台网络问题。 |
| 每月赞助 18.8 RMB<br>每年赞助 120 RMB | vip1 | 💕 全部功能,软件自动更新(从CDN下载),更新快速便捷。AI配置指导，提示词参考等 |
| 每月赞助 28.8 RMB<br>每年赞助 240 RMB | vip2 | 💕 vip1全部功能,启动时自动同步最近24小时市场资讯(包括外媒简讯)，go-stock Ai助手等 |
| 每月赞助 X RMB | vipX | 🧩 更多计划，视go-stock开源项目发展情况而定...(承接GitHub项目README广告推广💖) |
## 🧩 重大功能开发计划
| 功能说明 | 状态 | 备注 |
|-----------------|----|----------------------------------------------------------------------------------------------------------|
| DeepAgents 模式 | ✅ | 内置任务规划、子 Agent 委派、文件系统与 StreamingShell 集成，Agent 可读取源码运行脚本（2026.08） |
| 技能管理（Skill） | ✅ | 基于 eino ADK skill 中间件的渐进式提示词注入，支持导入 ZIP 技能包、在线编辑、CodeMirror 6 代码高亮（2026.08） |
| 对话摘要中间件 | ✅ | 集成 eino ADK summarization，超阈值自动摘要历史，避免上下文溢出（2026.08） |
| 提示词模板 API 提供给 AI 调用 | ✅ | OpenAI 工具处理器 + Eino ADK 工具包装器，Agent 可查询使用提示词模板（2026.08） |
| 股票分析知识库 | 🚧 | 未来计划 (研究中心已有体现) |
| Ai智能选股 | ✅ | Ai智能选股功能(市场行情-》AI总结/AI智能体功能) |
| ETF支持 | 🚧 | ETF数据支持 (目前可以查看净值和估值) |
| 美股支持 | ✅ | 美股数据支持 |
| 港股支持 | ✅ | 港股数据支持 |
| 多轮对话 | ✅ | AI分析后可继续对话提问 |
| 自定义AI分析提问模板 | ✅ | 可配置的提问模板 [v2025.2.12.7-alpha](https://github.com/ArvinLovegood/go-stock/releases/tag/v2025.2.12.7-alpha) |
| 不再强制依赖Chrome浏览器 | ✅ | 默认使用edge浏览器抓取新闻资讯 |
## 👀 更新日志
### 2026.08.01 DeepAgents 模式重大升级：集成文件系统、StreamingShell 与技能管理
- 引入文件系统 Backend 与 StreamingShell，Agent 可读取项目源码、运行构建/测试命令
- 子进程控制台窗口自动隐藏（CREATE_NO_WINDOW），Shell 输出流式返回，便于调试
- 修复 Shell 执行 4 个 bug：Context 泄漏、死锁、重复 Wait()、缺少执行结果摘要
### 2026.08.01 新增技能管理（Skill）功能：基于 eino ADK skill 中间件的渐进式提示词注入
- 技能以文件系统目录形式存储（skills/<技能名>/SKILL.md），支持脚本与参考文档
- 技能管理界面：导入 ZIP 技能包、在线编辑所有文件、新建/删除文件、删除技能
- 集成 CodeMirror 6 代码编辑器，支持 Python/YAML/JSON 语法高亮
- 仅在 DeepAgents 模式下生效，AI 按需发现并加载匹配技能，节省上下文 token
### 2026.08.01 AI Agent 增强：集成摘要中间件与提示词模板 API
- 集成 eino ADK summarization 中间件，对话 token 超阈值时自动摘要历史（120k token / 80 消息触发），原始对话转存 logs/agent_transcript.md
- 提示词模板 API 接口提供给 AI 调用（OpenAI 工具处理器 + Eino ADK 工具包装器），Agent 可查询使用提示词模板
- 浮动 AI 助手缓存执行参数（模型/系统提示词/用户提示词/思考模式/记忆模式/Agent 模式），避免用户每次重选
### 2026.05.20 多周期K线图：新增SATS自感知趋势指标+13个TV指标集成
### 2026.05.15 新增基金K线和基金前十大重仓持仓数据功能
### 2026.04.12 引入AgentMode类型支持React和PlanExecute两种代理模式
### 2026.04.11 引入MCP工具调用支持支持
### 2026.04.04 添加节假日工具支持
### 2026.04.03 添加节股票异动数据(A股当日)
### 2026.03.10 新增AI助手功能
### 2026.02.08 完善AI推荐股票功能和数据查询功能
### 2026.01.25 添加AI分析报告和ai推荐股票的历史数据查看功能
### 2025.12.16 新增AI思考模式与热门选股策略功能
### 2025.11.21 新增带频率权重的情感分析功能
### 2025.10.30 添加AI智能体功能开关(默认关闭，因为使用体验不理想)，移除页面水印
### 2025.09.27 添加机构/券商的研究报告AI工具函数
### 2025.08.09 添加AI智能体聊天功能
### 2025.07.08 实现软件自动更新功能
### 2025.07.07 卡片添加迷你分时图
### 2025.07.05 MacOs支持
### 2025.07.01 AI分析集成工具函数，AI分析将更加智能
### 2025.06.30 添加指标选股功能
### 2025.06.27 添加财经日历和重大事件时间轴功能
### 2025.06.25 添加热门股票、事件和话题功能
### 2025.06.18 更新内置股票基础数据,软件内实时市场资讯信息提醒，添加行业研究功能
### 2025.06.15 添加公司公告信息搜索/查看功能
### 2025.06.15 添加个股研报到弹出菜单
### 2025.06.13 添加个股研报功能
### 2025.06.12 添加龙虎榜功能，新增行业排名分类
### 2025.05.30 优化股票分时图显示
### 2025.05.20 修复财联社电报获取问题
### 2025.05.16 优化资金趋势图表组件
### 2025.05.15 重构应用加载和数据初始化逻辑，添加股票资金趋势功能，资金趋势图表增加主力当日净流入数据并优化展示效果
### 2025.05.14 添加个股资金流向功能，排行榜增加股票行情K线图弹窗
### 2025.05.13 添加行业排名功能
### 2025.05.09 添加A股盘口数据解析和展示功能
### 2025.05.07 优化分时图的展示
### 2025.04.29 补全港股/美股基础数据，优化港股股价延迟问题，优化初始化逻辑
### 2025.04.25 市场资讯支持AI分析和总结：让AI帮你读市场！
### 2025.04.24 新增市场行情模块：即时掌握全球市场行情资讯/动态，从此再也不用偷摸去各大财经网站啦。go-stock一键帮你搞定！
### 2025.04.22 优化K线图展示，支持拉伸放大，看得更舒服啦！
### 2025.04.21 港股，美股K线数据获取优化
### 2025.04.01 优化部分设置选项，避免重启软件
### 2025.03.31 优化数据爬取
### 2025.03.30 AI自动定时分析功能
### 2025.03.29 多提示词模板管理，AI分析时支持选择不同提示词模板
### 2025.03.28 AI分析结果保存为markdown文件时，支持保存位置目录选择
### 2025.03.15 自定义爬虫使用的浏览器路径配置
### 2025.03.14 优化编译构建，大幅减少编译后的程序文件大小
### 2025.03.09 基金估值和净值监控查看
### 2025.03.06 项目社区分享功能
### 2025.02.28 美股数据支持
### 2025.02.23 弹幕功能，盯盘不再孤单，无聊划个水！😎
### 2025.02.22 港股数据支持(目前有延迟)
### 2025.02.16 AI分析后可继续对话提问
- [v2025.2.16.1-alpha](https://github.com/ArvinLovegood/go-stock/releases/tag/v2025.2.16.1-alpha)
### 2025.02.12 可配置的提问模板
- [v2025.2.12.7-alpha](https://github.com/ArvinLovegood/go-stock/releases/tag/v2025.2.12.7-alpha)
## 🦄 重大更新
### BIG NEWS !!! 重大更新！！！
- 2026.03.10 新增AI助手功能
- 2025.11.21 新增带频率权重的情感分析功能
- 2025.04.25 市场资讯支持AI分析和总结：让AI帮你读市场！
- 2025.04.24 新增市场行情模块：即时掌握全球市场行情资讯/动态，从此再也不用偷摸去各大财经网站啦。go-stock一键帮你搞定！
- 
- 2025.01.17 新增AI大模型分析股票功能
## 📸 功能截图
### 设置
### 成本设置
### 日K
### 分时
### 钉钉报警通知
### AI分析股票
### 版本信息提示
## 💕 感谢以下项目
- [NaiveUI](https://www.naiveui.com/)
- [Wails](https://wails.io/)
- [Vue](https://vuejs.org/)
- [Vite](https://vitejs.dev/)
- [Tushare](https://tushare.pro/register?reg=701944)
## ⭐ Star History
<a href="https://www.star-history.com/?repos=ArvinLovegood%2Fgo-stock&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=ArvinLovegood/go-stock&type=date&theme=dark&legend=top-left&sealed_token=v0N4_yMF24lv7OpfWCO3O1wo4Uwy0VjIsJ5qwwsIwEF4A56MdI6nHkqhEzkKymHUvmjlD78zvdwTfg2D0JMcQNt-_KyxVlg7QWPCgln7DXSB7yr2lyYp5g" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=ArvinLovegood/go-stock&type=date&legend=top-left&sealed_token=v0N4_yMF24lv7OpfWCO3O1wo4Uwy0VjIsJ5qwwsIwEF4A56MdI6nHkqhEzkKymHUvmjlD78zvdwTfg2D0JMcQNt-_KyxVlg7QWPCgln7DXSB7yr2lyYp5g" />
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=ArvinLovegood/go-stock&type=date&legend=top-left&sealed_token=v0N4_yMF24lv7OpfWCO3O1wo4Uwy0VjIsJ5qwwsIwEF4A56MdI6nHkqhEzkKymHUvmjlD78zvdwTfg2D0JMcQNt-_KyxVlg7QWPCgln7DXSB7yr2lyYp5g" />
</picture>
</a>
## 🤖 状态
## 🐳 关于技术支持申明
- 本软件基于开源技术构建，使用Wails、NaiveUI、Vue、AI大模型等开源项目。 技术上如有问题，可以先向对应的开源社区请求帮助。
- 开源不易，本人精力和时间有限，如需一对一技术支持，请先赞助。联系QQ(备注 技术支持)：506808970
[//]: # (<img src="./build/wx.jpg" width="301px" height="402px" alt="ArvinLovegood">)
| 技术支持方式 | 赞助(元) |
|:--------------------------------|:-----:|
| 加 QQ：506808970 | 100/次 |
| 长期技术支持（不限次数，新功能优先体验等） | 5000 |
## License
[GNU GPLv3](LICENSE)
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues