DTS Hub

DTS CloudMaster MCP ​

适用版本：DTS Cloud 7.0 / 7.1 · MCP Host 1.0.0.0 · 2026-09-15

DTS CloudMaster MCP 是随 DTS Cloud 安装提供的本地管理工具。连接 Codex 等 MCP 客户端后，可以用自然语言查询 Cloud 服务和授权状态、控制完整服务生命周期，并打开视频流或 API 测试页面。DTS Cloud 7.1 进一步支持直接添加和移除 ACP、DTML 工程。

本工具已经包含在 DTS Cloud 中，本页不提供独立下载。

能解决什么问题 ​

  • 不打开多层菜单，直接查询 CloudMaster 和主要子服务是否正在运行。
  • 在维护操作前检查本机授权、产品类型、有效期和节点数。
  • 经过明确确认后，启动、停止或重启 CloudMaster 编排的完整 Cloud 服务。
  • 使用 Cloud 当前配置打开视频流测试页面或 API 示例页面。
  • 在 DTS Cloud 7.1 中，将 .acp 或 .dtml 工程直接加入 CloudMaster。
  • 生成 DTML 后形成“验证工程 → 加入 Cloud → 视频流预览”的完整验收链路。

版本能力差异 ​

本机安装包实测结果如下。7.0 和 7.1 都支持 MCP，但不要混用工具名。

能力DTS Cloud 7.0DTS Cloud 7.1
MCP 协议2025-06-182025-06-18
服务状态get_service_statuscloudmaster_get_service_status
授权信息get_license_infocloudmaster_get_license_info
启动服务start_servicecloudmaster_start_service
停止服务stop_servicecloudmaster_stop_service
重启服务restart_servicecloudmaster_restart_service
视频流测试页open_player_pagecloudmaster_open_player_page
API 示例页open_api_pagecloudmaster_open_api_page
添加工程不支持cloudmaster_add_project
删除工程不支持cloudmaster_delete_project
工具数量79

若一台电脑同时安装 7.0 和 7.1，应选择与当前运行的 CloudMaster 相同版本的 McpHost.exe，不要同时连接两个版本操作同一套服务。

程序位置 ​

默认安装在当前 Windows 用户的 Roaming 目录：

text
C:\Users\<用户名>\AppData\Roaming\DTS Cloud\7.0\CloudMaster\CloudMaster.McpHost.exe
C:\Users\<用户名>\AppData\Roaming\DTS Cloud\7.1\CloudMaster\CloudMaster.McpHost.exe

路径最后不要添加反斜杠；目标是可执行文件，不是文件夹。升级或重新安装后，应重新检查实际版本目录和程序数字签名。

在 Codex 中连接 ​

桌面设置 ​

  1. 打开 Codex 的 MCP 服务器设置。
  2. 添加一个 STDIO 服务器。
  3. 名称填写 dts-cloudmaster-71 或便于识别的名称。
  4. 命令填写当前版本 CloudMaster.McpHost.exe 的完整路径。
  5. 不需要 URL、命令参数或 OAuth。
  6. 保存并重启客户端，再用 /mcp 查看连接状态和工具列表。

config.toml 示例 ​

下面以 DTS Cloud 7.1 为例。请把用户名和安装版本替换为本机实际值：

toml
[mcp_servers.dts-cloudmaster-71]
command = 'C:\Users\<用户名>\AppData\Roaming\DTS Cloud\7.1\CloudMaster\CloudMaster.McpHost.exe'
enabled = true
startup_timeout_sec = 15
tool_timeout_sec = 120
default_tools_approval_mode = "writes"

writes 审批模式允许只读查询正常执行，并在启动、停止、重启、工程增删和打开页面等非只读操作前请求确认。

如果只允许审计，可限制为两个只读工具：

toml
[mcp_servers.dts-cloudmaster-71]
command = 'C:\Users\<用户名>\AppData\Roaming\DTS Cloud\7.1\CloudMaster\CloudMaster.McpHost.exe'
enabled = true
enabled_tools = [
  "cloudmaster_get_service_status",
  "cloudmaster_get_license_info",
]

DTS Cloud 7.1 工具说明 ​

只读查询 ​

工具作用注意事项
cloudmaster_get_service_status查询完整服务及 CloudServer、NodeService、中继和 3DT 文件服务的进程状态不包含工程、实例、节点或客户端连接详情
cloudmaster_get_license_info查询 CloudMaster 当前加载的授权序列号和授权主体不应进入公开日志

服务控制 ​

工具作用风险
cloudmaster_start_service启动完整 Cloud 服务；已运行时不重复启动会启动多个本机服务进程
cloudmaster_stop_service停止完整 Cloud 服务会中断正在运行的实例和客户端连接
cloudmaster_restart_service停止后重新启动完整 Cloud 服务会产生明确的服务中断

这里的“启动、停止、重启”是完整服务级操作，不是单个渲染实例操作。

工程管理 ​

工具输入作用
cloudmaster_add_projectprojectPath：ACP 或 DTML 的绝对路径加入 CloudMaster，并同步界面、配置、本机节点和 CloudServer
cloudmaster_delete_projectprojectName：不含扩展名从工程列表和配置中移除，但不删除磁盘文件

添加工程前需要确认：

  1. 工程文件存在，扩展名为 .acp 或 .dtml。

  2. Explorer 工程版本与目标 Cloud 版本兼容。

  3. 多节点环境中，所有节点都能访问工程，且本地路径完全一致。

  4. DTML 的资源路径有效，并包含同名伴随目录：

    text
    项目名.dtml
项目名_files\

  5. CloudMaster 中没有同名工程。

删除工程虽然不会删除磁盘文件，但会停止并重置引用该工程的实例；默认 demo 工程不能删除。

测试页面 ​

工具作用
cloudmaster_open_player_page使用当前服务配置打开本机视频流测试页
cloudmaster_open_api_page打开包含接口列表、实时日志、三维窗口和 JavaScript 编辑区的 API 示例页

播放器支持通过工程 ID 指定要加载的工程，例如：

text
http://127.0.0.1:8080/locale/zh/player.html?pid=<工程ID>

如果实例已经锁定或绑定其他工程，需要先在 CloudMaster 中解除绑定；否则传入新的工程 ID 后可能一直停留在连接阶段。

推荐工作流 ​

只读检查 ​

text
请只读检查 DTS CloudMaster 服务状态，不要启动、停止或重启任何服务。

添加并预览 DTML ​

先检查，不直接修改：

text
请检查这个 DTML 是否存在、是否有同名 _files 目录，以及资源路径是否有效；不要添加工程。
工程路径：E:\项目\示例.dtml

检查通过后再明确授权：

text
确认把 E:\项目\示例.dtml 添加到 CloudMaster。不要重启服务；添加成功后用视频流打开并验证实际画面。

推荐链路：

text
生成 DTML 与同名 _files
  → 验证坐标系、资源路径和版本
  → 添加到 CloudMaster
  → 查询服务状态
  → 用 player.html?pid=<工程ID> 打开
  → 确认视频正在播放
  → 检查建筑、道路、水面、植被等实际空间内容

服务维护 ​

text
先只读检查 CloudMaster 状态。若服务已经运行，不执行操作；若未运行，向我汇报并等待确认。

停止或重启时，应明确说明当前实例和连接将被中断，并逐次取得确认。

实际验收记录 ​

以下能力已在 DTS Cloud 7.1 本机环境完成真实验证：

  • CloudMaster.McpHost.exe 数字签名有效。
  • MCP 初始化成功，服务名为 CloudMaster.McpHost，协议为 2025-06-18。
  • 枚举到 9 个工具，并成功执行只读服务状态查询。
  • 使用 cloudmaster_add_project 成功加入一个 EPSG:3857 DTML 工程。
  • 清除实例原有工程绑定后，通过 player.html?pid=<工程ID> 建立视频流。
  • 视频达到 readyState=4、持续播放且无媒体错误；画面中可见建筑、地面和植被。
  • 本次流程不需要重启 Cloud 服务。

DTS Cloud 7.0 已完成 MCP 握手及 7 个工具的枚举，但没有执行写操作，也没有发现工程添加/删除工具。

能力边界 ​

CloudMaster MCP 是管理入口，不是完整的 DTS 场景 SDK。它不直接提供相机、标注、模型、图层、天气或量算接口。

建议按层使用：

  1. CloudMaster MCP：服务生命周期、授权、工程注册和测试页面。
  2. CloudServer 运行接口：工程、实例、节点和连接等运行时详情。
  3. DigitalTwinPlayer + fdapi：场景内相机、标注、图层和业务控制。
  4. CloudMaster UI：复杂配置、实例绑定和最终人工验收。

安全建议 ​

  • 默认启用写操作审批，不让模型自动停止或重启服务。
  • 调用生命周期工具前，同时核对进程身份、程序路径和当前服务状态。
  • 添加工程前保留源工程与 CloudMaster 配置的可恢复副本。
  • 删除工程前检查引用实例；不要把“不删除磁盘文件”理解为“没有运行影响”。
  • 工具返回成功后仍要重新查询状态，并通过真实视频流验收画面。
  • 不在公开记录中展示授权序列号、访问密码、内部服务地址或完整运行日志。

常见问题 ​

MCP 已连接，但状态查询失败 ​

确认 CloudMaster 主程序正在运行，并且它与 MCP Host 来自同一个 DTS Cloud 版本目录。

添加工程失败 ​

重点检查绝对路径、文件权限、ACP/DTML 扩展名、工程版本、同名工程和多节点路径一致性。DTML 中引用的 3DT 资源也必须在渲染节点上有效。

页面一直显示连接中 ​

先检查实例是否锁定或绑定了其他工程，再确认服务状态、工程 ID、授权和可用并发。解除旧工程绑定后重新刷新播放器。

为什么不能直接控制相机或添加标注 ​

当前 CloudMaster MCP 没有暴露 fdapi。场景接口必须在 DigitalTwinPlayer 的 API 就绪后，通过 fdapi.camera、fdapi.marker 等对象调用。

参考资料 ​