用途:在所属项目内实现所需的 DCC-MCP 适配器或服务,用于构建或现代化适配器及独立工作室 MCP 服务。私有服务无需公开仓库、目录条目、issue 或发布。操作已有应用时使用 dcc-mcp,处理单个工具包时使用 dcc-mcp-skills-creator。已加载的技能无需安装或新增 agent 轮次。
主要能力与实现边界:使用 DccServerBase 与 DccServerOptions.from_env(...),宿主 API 调用经由 HostExecutionBridge。内嵌、sidecar 与独立服务的属主/宿主生命周期不同,接线运行时应先确定该契约。复用 Core 的公开生命周期、发现与状态属主,避免并行适配器实现。身份与宿主配置保持数据驱动。
应用 UI:使用项目自有的 dcc-cua / ui-control。观察或输入前需报告 provider=dcc-cua runtime=<version> pid=<exact-pid> hwnd=<exact-native-hwnd>;缺少绑定则阻断操作。UI 工作读取自带的 dcc-cua 技能,未获用户明确更换 provider 前不得回退到通用 Computer Use。
指导选择(工作—阅读):新适配器或改造—适配器工作流与宿主模式;私有独立服务—内部服务工作流;服务属主、宿主派发、状态摘要、UI 集成、网关或 sidecar 接线—运行时集成及相关编号契约;针对共享行为的适配器本地权宜方案—Core 升级;异步/主线程任务、取消或重连—异步恢复;运行时故障或问题归属—故障路由;Nuke/独立示例或跨 DCC 文件同步—集成示例;验证或发布—测试与发布。
使用与验证:仅在需要实时验证时使用 dcc-mcp 路由;纯源码编辑无需启动宿主、安装 CLI 或更新服务器。运行相关本地检查,修复由改动导致的失败,并在报告完成前验证所需行为。源码/模拟验证与真实宿主验收分开。发布需要所请求的范围与适用发布门禁;原生 Python 3.7 仍为 LTS 配置,py37-lite 不满足其发布门禁。
硬性限制:不得从 Tokio/HTTP 工作线程触碰 DCC API;当 Core 已暴露类型化对象或目录 API 时,不要在适配器运行时代码中解析或重写 SKILL.md、tools.yaml、groups.yaml 或 prompt/workflow 文件;除非没有公开 Core API,否则不要访问 server._server,若必须则提交 Core issue 并保持适配器 shim 精简;不得在共享 Core 或适配器模板中创建 Maya 专用抽象;类型化技能可覆盖任务时,不得将原始脚本执行作为主要用户工作流;私有内部服务不要求 GitHub、公开目录条目或公开 issue 跟踪;不得在公开 issue 或 PR 文本中发布本地路径、私有机器名或来源归属标记。