前言¶
在 DSH / 智能体开发中,给工具链增加一组外部数据工具时,常会碰到依赖安装、API key、硬编码路径和 MCP 帧格式不一致的问题。下面介绍 helibeiqi/dsh-quant-data-mcp:一个零依赖 MCP stdio server 通用模板 + A 股数据开箱示例,可作为 DeepSeek Harness(dsh)的 bundle 安装。
这是什么¶
dsh-quant-data-mcp 是零依赖 MCP stdio server 通用模板 + A 股数据开箱示例,可作为 DeepSeek Harness(dsh)的 bundle 安装。维护者为 helibeiqi。
它只使用 Node 内置模块,无需 pnpm、npm install 或构建;使用公开免密钥数据源(东方财富 / 腾讯);路径全环境变量化,通过 !!js process.env.X 在 dsh 启动时解析;按 MCP 官方 NDJSON 帧格式实现。
当前 package.json 版本为 0.2.0。运行时要求:
Node.js >= 18
DSH v0.1.0-rc.6 及以上
核心功能¶
下面列出已核实的核心能力:
1、零依赖:仅使用 Node 内置模块,无需 pnpm、npm install 或构建。
2、无 API key:使用公开免密钥数据源(东方财富 / 腾讯)。
3、路径全环境变量化:通过 !!js process.env.X 在 dsh 启动时解析。
4、按 MCP 官方 NDJSON 帧格式实现。
5、可作为 DeepSeek Harness(dsh)的 bundle 安装。
6、提供以下 6 个工具:
a_share_daily
quote_snapshot
quote_batch
financials
northbound
sectors
7、a_share_daily 支持东方财富与腾讯数据源回退。
8、支持通过 QUANT_MCP_LOG 开启 server 端日志。
安装与启用¶
Windows / PowerShell 一键安装¶
在 PowerShell 中执行:
pwsh -File setup.ps1
也可以按需指定参数:
pwsh -File setup.ps1 -DshHome <DshHome> -Node <node>
手动安装¶
手动安装时,先拷贝 bundle 目录:
<DshHome>\profiles\node_modules\dsh-quant-data-mcp\
然后在 web profile 的 package.json 中,把以下 bundle 名称加入 dsh.profile.bundles 数组:
"dsh-quant-data-mcp"
环境变量¶
启动 dsh 前,需要设置以下必填变量:
QUANT_MCP_NODE
QUANT_MCP_SERVER
QUANT_MCP_CWD
这三个变量必填且无默认值。
可选设置:
QUANT_MCP_LOG
QUANT_MCP_LOG 未设置时不写日志。
验证¶
安装并重启 dsh 后,可以做以下检查:
1、检查端口监听:
netstat -ano | findstr 8787
2、检查任务管理器中的 node 子进程。
3、如果设置了 QUANT_MCP_LOG,查看日志中 tools/list 的 6 个工具:
a_share_daily
quote_snapshot
quote_batch
financials
northbound
sectors
如果只想单独验证 MCP server 协议,也可以用 MCP SDK 客户端,例如 StdioClientTransport + Client,依次执行:
connect
listTools
callTool
典型用法¶
安装并设置环境变量后,dsh-quant-data-mcp 作为 dsh bundle 启动,并在 tools/list 中暴露上述 6 个工具。
其中 a_share_daily 支持东方财富与腾讯数据源回退。若需要排查 server 行为,可以设置 QUANT_MCP_LOG,查看 server 端日志。
适用场景与注意¶
这个插件适合两类用途:一是在 dsh 中注册一组本地 A 股数据 MCP 工具;二是把其中的 server 作为零依赖 MCP stdio server 模板,替换为自己的工具和数据源。
它是模板 + 示例,不是一站式量化平台。
插件以当前 dsh 进程权限运行,安装前应检查源码,并确认许可证条款。当前资料未给出明确许可证类型,仅说明 package.json 的 files 包含 LICENSE。
使用注意:
1、需要 Node.js >= 18,支持 DSH v0.1.0-rc.6 及以上。
2、dsh 升级会重置 bundle 相关补丁,升级后需重跑:
pwsh -File setup.ps1
3、部分网络可能封锁东方财富 push2*.eastmoney.com 的某些端点;a_share_daily 有自动回退。
4、资料列出多个已实测不可用的数据端点,禁止复用。
5、东方财富金额多为元,server 统一 /1e8 转亿元。
6、这是纯本地 stdio 进程,不写入系统目录、不注册系统服务。
卸载¶
如果需要移除,可以按下面顺序处理:
1、从 dsh.profile.bundles 删除:
"dsh-quant-data-mcp"
2、删除 bundle 目录:
<DshHome>\profiles\node_modules\dsh-quant-data-mcp
3、按需清理以下环境变量:
QUANT_MCP_NODE
QUANT_MCP_SERVER
QUANT_MCP_CWD
QUANT_MCP_LOG
结尾¶
dsh-quant-data-mcp 的价值在于提供一个可直接落地的 dsh bundle:零依赖、免密钥、路径环境变量化、按 MCP 官方 NDJSON 帧格式实现,并附带 A 股数据示例。
目录页与源码地址如下:
https://www.skillhub.cn/plugins/helibeiqi/dsh-quant-data-mcp
https://github.com/helibeiqi/dsh-quant-data-mcp