# MCP Tools 使用指南

本指南面向使用 AI 助手（Claude、Cursor 等）以自然语言控制 Maya 的用户，无需任何 Python 知识。

## 工作原理

`dcc-mcp-maya` 服务器在 Maya 内运行后，你的 AI 助手可以发现 **24 个 Maya Skill 包**，并按需加载 **170+ 个 typed Maya 工具**。只需用普通话描述你的需求即可；助手应先搜索能力、加载匹配 Skill，再调用带 schema 的 typed tool。

默认启动工具面很小。如果某个工具看起来不存在，请让助手先调用 `dcc_capability_manifest` 或 `search_skills`，再调用 `load_skill("<skill-name>")`。

## 场景操作

### 创建与管理场景

```
"新建一个空场景"
"将当前场景保存到 /projects/my_scene.ma"
"打开文件 /projects/character.mb"
"当前帧率是多少？改成 30fps"
```

### 浏览场景

```
"列出场景中的所有对象"
"显示场景层次结构"
"场景里有多少对象？"
"选择所有网格对象"
"当前选中了什么？"
```

## 创建对象

### 基础几何体

```
"创建一个球体"
"创建一个宽度为 2 的立方体，命名为 'table'"
"创建一个地面平面，缩放到 10x10"
"在位置 (3, 0, 0) 创建一个圆柱体"
```

### 变换操作

```
"将 pSphere1 移动到位置 (0, 5, 0)"
"将立方体绕 Y 轴旋转 45 度"
"将 pPlane1 在 X 和 Z 方向缩放为 5"
"冻结所有选中对象的变换"
"将 my_mesh 的轴心居中"
```

### 对象管理

```
"将 pSphere1 重命名为 'ball'"
"复制这个立方体并向右移动 3 个单位"
"删除 pCone1"
"将 sphere1、cube1 和 cylinder1 编组为 'objects'"
"将 sphere1 放到 group1 下"
"隐藏 camera_rig 组"
"锁定 ground_plane 的变换"
```

## 材质与着色

```
"创建一个名为 'redMat' 的红色 Lambert 材质"
"制作一个闪亮的金色材质"
"将 redMat 赋予 pSphere1"
"创建一个透明材质并赋予玻璃对象"
"列出场景中的所有材质"
"将 material1 的颜色改为蓝色"
```

## 动画

```
"在第 1 帧给 pSphere1 打关键帧"
"设置 ball 的 translateY：第 1 帧=0，第 24 帧=5，第 48 帧=0"
"将时间轴设置为第 1 帧到第 120 帧"
"跳转到第 50 帧"
"当前在哪一帧？"
"将 pCloth1 的模拟从第 1 帧烘焙到第 100 帧"
"删除 pSphere1 在第 20 到 40 帧之间的所有关键帧"
"将 character_ctrl 的动画曲线导出到 /exports/walk_cycle.anim"
```

## 灯光 Rig

```
"围绕资产创建一个三点布光 rig"
"使用 /textures/studio.hdr 创建 HDRI dome"
"列出当前场景中的灯光 rig"
"降低 key light 的强度"
```

## 场景装配

```
"为这个道具创建 assembly definition"
"给 assembly 添加 GPU cache representation"
"在 layout 场景中创建 assembly reference"
"列出所有 assemblies"
```

## 渲染与截图

```
"截取当前视口截图"
"从正视图截取场景"
"将渲染分辨率设为 1920x1080"
"将渲染器设置为 Arnold"
"当前的渲染设置是什么？"
```

## 进阶工作流

### Skill 路由

```
"找到最适合导出所选 mesh 到 FBX 的 skill，加载它，然后导出"
"显示未加载的 render 和 farm 工具 capability manifest"
"加载 maya-material-library，并把这个 shader network 保存为 preset"
```

### 完整资产创建

```
"创建一张桌子：一个扁平立方体作为桌面（缩放 4x0.2x2，高度 2），
 四根圆柱腿（缩放 0.1x1x0.1）放在四个角落。
 给所有对象应用棕色木纹材质。"
```

### 动画设置

```
"我需要一个弹跳球动画：
 - 创建名为 'ball' 的球体，位置 (0,0,0)
 - 设置关键帧：第 1 帧 Y=0，第 12 帧 Y=5，第 24 帧 Y=0
 - 将时间轴设为 1-48 帧
 - 截图看看效果"
```

### 场景检查

```
"给我一份当前场景的完整报告：
 - 有多少对象？
 - 使用了哪些材质？
 - 渲染设置是什么？
 - 给我看一张截图"
```

## 使用技巧

1. **明确对象名称** — 使用 Maya 显示的确切名称（如 `pSphere1`，而非仅仅 `球体`）
2. **链式操作** — 可以在一条消息中描述多步骤工作流
3. **要求确认** — 操作后说"给我看张截图"来验证结果
4. **使用自然单位** — "1 单位" = 1 个 Maya 单位（通常为 1 厘米或 1 米，取决于场景比例）
