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

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

小夜