Claude Code DTS MCP 插件

面向 https://192.168.50.170:8770/mcp 的 DTS Engine 网关的私有 Claude Code 插件。

它使 macOS 或 Windows 上的 Claude Code 能够上传源数据、将 Windows DTS Engine 6.1 发布任务加入队列、监控这些任务，并下载经过哈希验证的 3DT 结果。该插件不包含 DTS Engine 二进制文件，也不包含服务器机密。

这是 codex-dts-mcp-plugin 的 Claude Code 对应版本，后者为 macOS 上的 Codex 提供相同的网关。两个插件可以共享相同的已存储 Bearer Token，因为它们面向相同的网关和相同的 DTS_MCP_TOKEN 环境变量。

先决条件

• 客户端计算机可以通过私有局域网或 VPN 路由到 192.168.50.170:8770。

• GitHub 访问可以克隆 zhouning/claudecode-dts-mcp-plugin。

• 已安装 Claude Code CLI（claude plugin --help 成功执行）。

• Windows DTS MCP 网关健康，DTS Engine 已安装、获得许可，并在已登录的交互式 Windows 会话中运行。

• 你通过安全渠道获得了网关 Bearer Token。

不要将 token 粘贴到 shell 命令中。两个安装程序都会在终端不回显的情况下提示输入：configure-macos.sh 将其存储在 macOS 登录钥匙串中，configure-windows.ps1 将其存储在 Windows 凭据管理器中。

在 macOS 上安装

git clone git@github.com:zhouning/claudecode-dts-mcp-plugin.git
./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/configure-macos.sh

该脚本仅将公共 DTS MCP CA 导入登录钥匙串，将 Bearer Token 存储在服务 dts-mcp 下，安装一个恢复 DTS_MCP_TOKEN 的用户 LaunchAgent，添加 zhouning-dts 市场，安装 dts-mcp@zhouning-dts，并验证固定的健康端点。

通过以下命令验证：

./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/verify-connection-macos.sh

在 Windows 上安装

git clone https://github.com/zhouning/claudecode-dts-mcp-plugin.git
.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\configure-windows.ps1

该脚本将 Bearer Token 作为通用凭据存储在 Windows 凭据管理器中，目标为 dts-mcp，将 DTS_MCP_TOKEN 持久化为用户环境变量并广播更改，以便新进程能看到它，信任 Cert:\CurrentUser\Root 中的捆绑 CA，添加 zhouning-dts 市场，安装 dts-mcp@zhouning-dts，并验证固定的健康端点。

通过以下命令验证：

.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\verify-connection-windows.ps1

在任一平台上安装后，请重启 Claude Code 并打开新会话。

更新

git -C claudecode-dts-mcp-plugin pull --ff-only
claude plugin marketplace update zhouning-dts
claude plugin install dts-mcp@zhouning-dts

更新后，请重启 Claude Code 并使用新会话。

轮换 Bearer Token

先在 Windows 网关上轮换 token，然后运行：

./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/configure-macos.sh --rotate-token

.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\configure-windows.ps1 --rotate-token

刷新 CA

在 Windows 主机地址或 DTS MCP CA 更改后，更新 checkout 并运行：

git -C claudecode-dts-mcp-plugin pull --ff-only
./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/configure-macos.sh --refresh-ca
./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/verify-connection-macos.sh

git -C claudecode-dts-mcp-plugin pull --ff-only
.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\configure-windows.ps1 --refresh-ca
.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\verify-connection-windows.ps1

刷新不会读取或重写 Bearer Token。丢弃在端点或签名密钥更改之前签发的签名 URL。

移除

macOS：

claude plugin uninstall dts-mcp
claude plugin marketplace remove zhouning-dts
launchctl bootout "gui/$UID/com.dts.mcp.token" 2>/dev/null || true
rm -f "$HOME/Library/LaunchAgents/com.dts.mcp.token.plist"
rm -rf "$HOME/Library/Application Support/dts-mcp"
security delete-generic-password -a "$USER" -s dts-mcp
launchctl unsetenv DTS_MCP_TOKEN

Windows：

claude plugin uninstall dts-mcp
claude plugin marketplace remove zhouning-dts
[Environment]::SetEnvironmentVariable('DTS_MCP_TOKEN', $null, 'User')
cmdkey /delete:dts-mcp 2>$null

仅在确认指纹后，从登录钥匙串（security delete-certificate）或 Cert:\CurrentUser\Root（Remove-Item）中移除 DTS MCP Local CA 证书。

发布约束

• 只有 road 经过了端到端验证。

• Road 输入需要投影 CRS 和 domPath；强烈建议使用匹配的 DEM。

• OSGB 发布需要两个阶段，并且必须使用 dts_publish_osgb。

• 远程路径标志使用工件 ID 和工件相对路径，绝不使用 Windows 路径。

• 上传和下载的字节使用带签名的 HTTPS URL，不携带 Bearer Token。

• 远程网关注册了 14 个工具；dts_validate 仍仅限本地。

• 成功的结果 ZIP 必须同时保留其 .3dt 数据和 DataInfor.txt。

故障排除顺序

1. 确认到 192.168.50.170:8770 的私有路由。

2. 确认 Windows 主机已登录且 DTS MCP 网关健康。

3. 运行平台的 verify-connection-* 脚本并修复第一个失败的层。

4. 对于身份验证失败，使用 --rotate-token。

5. 在地址或证书更改后使用 --refresh-ca。

6. 确认 dts-mcp 出现在 claude plugin list 中。

7. 确认 dts 出现在 claude mcp list 中。

8. 启动新的 Claude Code 会话并调用 dts_ping。

验证状态

• DTS 服务器远程网关实现及其自身的远程冒烟测试：未从此仓库重新验证；参见 zhouning/dts-mcp-server。

• 插件清单、Skill、证书、脚本语法和机密检查：由此仓库的测试覆盖。

• Windows 凭据管理器和 macOS 钥匙串的验收正在目标机器上进行。

• 在目标机器完成真实的 road 上传、发布、下载和 SHA-256 验证之前，不要报告端到端插件成功。