DTS CloudMaster MCP

本页以 DTS Cloud 7.0 的接入为例，并列出 7.1 的新增能力。CloudMaster MCP 随 DTS Cloud 安装，无需单独下载。

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

能解决什么问题

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

版本能力差异

DTS Cloud 7.0 提供 7 个工具，7.1 提供 9 个工具。请按安装版本使用对应的工具名。

能力	DTS Cloud 7.0	DTS Cloud 7.1
MCP 协议	2025-06-18	2025-06-18
服务状态	get_service_status	cloudmaster_get_service_status
授权信息	get_license_info	cloudmaster_get_license_info
启动服务	start_service	cloudmaster_start_service
停止服务	stop_service	cloudmaster_stop_service
重启服务	restart_service	cloudmaster_restart_service
视频流测试页	open_player_page	cloudmaster_open_player_page
API 示例页	open_api_page	cloudmaster_open_api_page
添加工程	不支持	cloudmaster_add_project
删除工程	不支持	cloudmaster_delete_project
工具数量	7	9

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

程序位置

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

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

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

连接 MCP 客户端

先启动对应版本的 CloudMaster，再在支持 MCP 的 AI 客户端中添加一个 STDIO 服务器：

配置项	填写内容
名称	dts-cloudmaster-70，或便于识别的名称
命令	当前版本 CloudMaster.McpHost.exe 的完整路径
参数	留空

连接不需要 URL 或 OAuth。保存后刷新连接或重启客户端，检查工具列表。使用 7.0 时应能看到 7 个工具；使用 7.1 时应能看到 9 个工具。

建议先调用服务状态查询，确认连接正常后再使用服务控制功能。根据客户端提供的权限设置，为停止、重启和工程增删等操作保留确认步骤。

DTS Cloud 7.0 工具说明

工具	作用
get_service_status	查询完整服务及 CloudServer、NodeService、中继和 3DT 文件服务的进程状态
get_license_info	查询 CloudMaster 当前加载的授权
start_service	启动完整 Cloud 服务；已运行时不重复启动
stop_service	停止完整 Cloud 服务
restart_service	停止后重新启动完整 Cloud 服务
open_player_page	使用当前服务配置打开视频流测试页
open_api_page	打开包含接口列表、日志、三维窗口和 JavaScript 编辑区的 API 示例页

服务状态查询不包含工程、实例、节点或客户端连接详情。授权信息中的序列号和授权主体不应公开分享。

启动、停止和重启作用于完整 Cloud 服务。停止或重启会中断正在运行的实例和客户端连接，请在维护前确认影响范围。

DTS Cloud 7.1 新增工程管理

7.1 的服务查询、控制和测试页面功能见上方版本对照表；工具名均带有 cloudmaster_ 前缀。此外，7.1 支持以下工程管理工具，7.0 不提供这两个工具。

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

添加工程前需要确认：

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

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

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

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

   项目名.dtml
   项目名_files\

5. CloudMaster 中没有同名工程。

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

视频流与 API 测试

使用对应版本的工具打开测试页面。播放器支持通过工程 ID 指定要加载的工程，例如（端口以实际服务配置为准）：

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

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

推荐工作流

只读检查

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

添加并预览 DTML（仅 7.1）

先检查，不直接修改：

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

检查通过后再明确授权：

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

推荐链路：

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

服务维护

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

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

能力边界

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

建议按层使用：

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

常见问题

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

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

添加工程失败（7.1）

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

页面一直显示连接中

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

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

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

相关资料

• DTS Hub · DTS CloudMaster MCP
• Cloud 手册
• SDK
• DTML 工程格式