前言¶
DeepSeek Harness (DSH) 通过插件机制扩展功能。当智能体需要调用外部数据时,通常涉及繁琐的 API 集成。dsh-stockmcp 解决了这一痛点,它作为一个 DSH 插件,将 stockmcp.net 远程 MCP 服务器的数据作为模型工具动态同步,无需手动编写数据获取逻辑。
是什么¶
这是一个由 StockMCP-net 维护的 DSH 插件。它通过远程 MCP 服务器获取数据,并将其转换为 DSH 的模型工具。该插件专注于提供美股及宏观经济相关的数据查询能力。
核心功能¶
- 实时行情与历史数据:提供实时行情、价格历史,以及涨跌榜和活跃股数据。
- 财务报表:支持利润表、资产负债表、现金流量表等财务数据查询。
- 公司事件与新闻:包含分红与拆股数据,以及 SEC 文件清单、段落内容、内幕交易记录和公司新闻。
- 宏观经济数据:提供宏观经济指标、国债利率、行业及行业快照数据。
- 配置热重载:支持通过设置页面、
settings.yaml或环境变量热重载 API Key。 - 多语言支持:界面及工具描述支持中文/英文,跟随 DSH 语言环境自动切换。
- 零依赖:纯 ESM 模块,无构建步骤。
安装与启用¶
安装需要 DeepSeek Harness 具备 web profile 且 Node.js 版本大于等于 20。
- 执行安装命令:
dsh plugin --profile web add dsh-stockmcp
- 重启 web profile,工具将自动出现:
pm2 restart dsh-web
# 或
dsh web
配置与使用¶
工具调用需要 stockmcp.net 的 API Key。支持三种配置方式:
- 设置页面:通过 DSH web 的设置页面配置,会写入
~/.dsh/settings.yaml。 - 配置文件:在
~/.dsh/settings.yaml中添加stockmcp: { apiKey: ... }。 - 环境变量:设置
STOCKMCP_API_KEY。
若不配置 Key,插件运行正常,但工具调用会报错。
迁移注意事项¶
若从旧的手动挂载方式迁移,需先移除 cordis.patch.yml 中的 ./node_modules/StockMCP/... 插入内容,再重启 profile,以避免重复挂载。
适用场景与注意¶
该插件适合需要访问实时金融数据、财务报表或宏观经济指标的 DSH 应用。注意事项包括:
- 必须使用带有
webprofile 的 DSH。 - 依赖 stockmcp.net API Key。
- 工具列表动态同步,每 10 分钟刷新一次。
- 遵循 MIT 许可证。
总结¶
该插件通过动态同步和热重载机制,为 DSH 提供了标准化的金融数据访问接口。更多详情可查阅社区目录或 GitHub 仓库。