Zhen-WushuiLingchun/dsh-wolfram-bundle

Project Overview项目介绍

dsh-wolfram is an integration bundle that wires Wolfram's official Wolfram/AgentTools MCP Server into DeepSeek Harness (DSH). It is a thin adapter, not a rewrite: MCP transport is delegated to DSH's generic @deepseek-ai/dsh-mcp-client, while Wolfram tools come from the upstream Paclet. The bundle fills three gaps: kernel discovery that locates a local Wolfram executable via the Windows registry, standard install roots, or wolframscript, with an explicit override path; a Windows stdio supervisor that guarantees only the Wolfram process tree started by this plugin gets terminated on close, HMR, or DSH exit, never an unrelated notebook kernel or another client's server; and DSH-native permission policy routed through the standard approval chain, defaulting side-effecting tools to ask and treating any unclassified new tool from a Paclet upgrade as ask rather than silently allowing it. Installation uses dsh plugin --profile <profile> add <path-or-tarball> and registration is verified with dsh --profile <profile> --dump-config, which should list id: wolfram and id: wolfram-permission.

By default the bundle connects to the built-in WolframLanguage server and exposes seven tools under the mcp__wolfram__ namespace: WolframLanguageEvaluator, TestReport, WriteNotebook, ReadNotebook, CodeInspector, WolframLanguageContext, and SymbolDefinition. The first five are read-write or otherwise side-effecting and default to ask; the last two return read-only documentation metadata and are delegated to downstream policy. Unlisted Wolfram tools are also ask until classified, because the upstream server's tools/list only supplies title annotations without readOnlyHint or destructiveHint. If the session approval policy is never, calls are rejected outright by DSH semantics; users wanting to relax a tool must move it into a delegate array via cordis.patch.yml, remembering that delegate is a whole-list replacement. WSL users reusing Windows Mathematica must set the POSIX state path and an explicit command, disable probeWolframscript, and rely on a narrow set of forwarded variables.

Dependencies are DSH itself (primary validation target 0.1.1-rc.2, still compatible with 0.1.0-rc.5), Node.js ^22.19 || >=24, pnpm, plus a Wolfram desktop product or Wolfram Engine with PacletInstall["Wolfram/AgentTools"] at version 2.2.0 or above. graceMs is capped below 2000 ms because StdioClientTransport.close() escalates to SIGTERM after two seconds, bypassing any JavaScript cleanup path. Limits include an unrecoverable Windows hard-kill window that only orphan reclamation can mitigate afterwards, an unverified POSIX identity-check branch, no bridging of MCP Resources or Prompts, no system prompt injection, and no second-layer approval storage beyond DSH's one-shot ctx.approval semantics. The package is licensed MIT, with offline rebuild metadata in docs/offline-dependencies.json.

dsh-wolfram 是面向 DeepSeek Harness(DSH)的专用集成 bundle,把 Wolfram 官方的 Wolfram/AgentTools MCP Server 接入 DSH。它本身是一层薄壳,不重写 MCP 协议,而是复用 DSH 通用的 @deepseek-ai/dsh-mcp-client,再补上三件事:自动发现本机 Wolfram 内核(注册表、标准安装根目录或 wolframscript,也支持显式覆盖)、Windows 上的 stdio supervisor 保证只终止本插件启动的进程树,以及 DSH 原生权限策略(求值、测试、读写 notebook 等副作用工具默认 ask,未知新工具同样要求审批)。安装时执行 dsh plugin --profile <profile> add <本地路径或 tarball>,bundle 会写入 profile 的 dsh.profile.bundles,随后用 dsh --profile <profile> --dump-config 确认 wolfram 与 wolfram-permission 两行。

模型默认连接内置 WolframLanguage server,会看到七个工具,统一以 mcp__wolfram__ 为前缀:WolframLanguageEvaluator、TestReport、WriteNotebook、ReadNotebook、CodeInspector、WolframLanguageContext、SymbolDefinition。其中前五个因可写文件、起进程、访问网络,默认都走 ask,后两个只读元数据则交给后续策略。官方 Paclet 升级后出现的新工具在没有分级信息前同样先问人。会话策略为 never 时调用会被直接拒绝,这是 DSH 既有语义;如需放宽,可通过 profile 的 cordis.patch.yml 把工具移到 delegate,但 delegate 是整表替换,须写全放行项。WSL 用户可复用 Windows Mathematica,需显式设置 POSIX state path 与 command,并把 probeWolframscript 关闭。

依赖方面需要 DSH(主验证目标 0.1.1-rc.2,兼容 0.1.0-rc.5)、Node.js ^22.19 || >=24、pnpm,以及安装好 Wolfram 桌面产品或 Wolfram Engine 并执行 PacletInstall["Wolfram/AgentTools"](需 2.2.0 或更高)。graceMs 必须小于 2000,否则会被配置校验拒绝。需注意 Wolfram 进程残留只能事后回收:Windows 强杀窗口无法完全消除,POSIX 分支的身份校验尚未在真实 macOS/Linux 上验证。本 bundle 只桥接 MCP Tools,不桥接 Resources 与 Prompts,且不注入 system prompt,凭据清洗沿用 DSH 通用过滤。License 为 MIT。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:Zhen-WushuiLingchun/dsh-wolfram-bundle

把 Zhen-WushuiLingchun/dsh-wolfram-bundle 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-wolfram

把 Wolfram 官方 Wolfram/AgentTools MCP Server 接进 DeepSeek Harness (DSH) 的专用集成 bundle。

它是一层薄集成,不重写任何一方:MCP 协议交给 DSH 通用的 @deepseek-ai/dsh-mcp-client,Wolfram 工具由官方 Paclet 提供。本包只补三件中间缺口:

  1. 内核发现 —— 自动找到本机的 Wolfram 可执行文件(注册表 / 标准安装根目录 / wolframscript),也支持显式覆盖。
  2. Windows 透明 stdio supervisor —— 保证连接关闭、HMR 重载、DSH 退出后,只有本插件自己启动的那棵 Wolfram 进程树被终止,绝不碰你已经开着的 Mathematica 前端、笔记本内核,或别的客户端启动的 AgentTools server。
  3. DSH 原生权限策略 —— 求值、跑测试、读写 notebook 这类有副作用的工具执行前先经 DSH 的审批链;未知的新工具默认也要问。
DSH 工具注册表
   ├── dsh-wolfram/policy   ← tools/pre-execute:分级 → ask / 交给后续策略
   └── dsh-wolfram          ← 发现内核,挂载子插件 ↓
         └── @deepseek-ai/dsh-mcp-client  (DSH 通用,未修改)
               └── node src/supervisor-main.js   ← 本包的 supervisor
                     └── wolfram.exe -run PacletSymbol["Wolfram/AgentTools", …][] -noinit -noprompt

前置条件

  • DeepSeek Harness(提供 dsh 命令)。当前主验证目标是官方 0.1.1-rc.2;0.1.0-rc.5 继续兼容。

  • Node.js ^22.19 || >=24、pnpm(dsh plugin 转发给 pnpm)。

  • 已安装 Wolfram 桌面产品或 Wolfram Engine,且已安装 Wolfram/AgentTools Paclet:

    PacletInstall["Wolfram/AgentTools"]
    

    验证:PacletObject["Wolfram/AgentTools"]["Version"] 应返回 2.2.0 或更高。


安装

dsh plugin --profile <你的 profile> add D:\dsh-dev\dsh-wolfram

add 后面可以是本地目录、tarball、git URL 或已发布的包名。dsh plugin 会在 $DSH_HOME/profiles/<profile>/ 里初始化 profile(如果还没有)、调用 pnpm 安装,然后检测到本包声明了 dsh.bundle 并把它追加进 dsh.profile.bundles 层列表。

确认它进了组合树:

dsh --profile <你的 profile> --dump-config

WSL 中复用 Windows Mathematica

0.2.0 起,bundle 在 WSL 中使用 POSIX state path,并只把 WSL_INTEROP、WSLENV、LANG、LC_ALL、TERM 这五类非秘密变量接入 supervisor。MCP_SERVER_NAME 会通过 WSLENV 的 /w 方向标记传入 Windows, 因此不会再静默启动错误的默认 server。请使用显式 WSL 路径并关闭自动探测:

- id: wolfram
  config:
    serverName: wolfram
    mcpServerName: WolframLanguage
    command: /mnt/d/mathematica/Mathematica 15.0/wolfram.exe
    probeWolframScript: false
    recordDirectory: /home/<user>/.local/state/dsh-wolfram
    reclaimOrphans: true

此模式已在 WSL2/Node 24.19.0 上实测 POSIX 单元套件自然退出,并由真实 AgentTools 2.2.0 完成 initialize、七工具 tools/list、精确只读求值和退出后 process-tree quiescence。它仍不是任意求值沙箱;部署时应把 unknown 设为 deny,高风险工具留在审批链中。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-openviking-enhance 下一个 Next dsh-goalmesh →