dsh-quant-data-mcp:零依赖 MCP stdio server 模板与 A 股数据示例

前言

在 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 内置模块,无需 pnpmnpm install 或构建;使用公开免密钥数据源(东方财富 / 腾讯);路径全环境变量化,通过 !!js process.env.Xdsh 启动时解析;按 MCP 官方 NDJSON 帧格式实现。

当前 package.json 版本为 0.2.0。运行时要求:

Node.js >= 18
DSH v0.1.0-rc.6 及以上

核心功能

下面列出已核实的核心能力:

1、零依赖:仅使用 Node 内置模块,无需 pnpmnpm install 或构建。

2、无 API key:使用公开免密钥数据源(东方财富 / 腾讯)。

3、路径全环境变量化:通过 !!js process.env.Xdsh 启动时解析。

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.jsonfiles 包含 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜