# MCP

MCP 就是 **模型上下文协议（Model Context Protocol）**，一套轻量的、基于 JSON 的封装，让客户端应用（例如 Cursor、VS Code 里的 Copilot、Claude 桌面版）不用去处理底层的 HTTP 细节，就能直接调用 YouCam AI 服务。

核心好处：在 MCP 配置 JSON 文件里加一条记录、填上您的 YouCam API 密钥，任何兼容 MCP 的客户端（Cursor、VS Code 里的 Copilot、Claude 桌面版）立刻就能用上整套 YouCam AI 服务——测肤、AI 时装虚拟试穿、发型、时尚渲染等等。客户端把请求组装、鉴权处理、异步轮询都包办了，开发者专注业务流程即可，不必纠缠底层接口机制。

## 集成指南

#### 1. 前置条件

* 装好一个兼容 MCP 的客户端（Claude 桌面版、Codex、Cursor、VS Code 里的 Copilot 等）。
* 网络能访问 YouCam MCP 服务器，共三类：
  * `https://mcp-api-01.makeupar.com/mcp/beauty`
  * `https://mcp-api-01.makeupar.com/mcp/fashion`
  * `https://mcp-api-01.makeupar.com/mcp/creators`
* 一个有效的 **YouCam API 密钥**（见下一节）。


> 客户端自身已经实现了请求/响应的序列化与轮询逻辑，开发者不需要再写额外代码。


#### 2. 获取 API 密钥

1. 打开 API 密钥控制台：[https://yce.perfectcorp.com/api-console/en/api-keys/](https://yce.perfectcorp.com/api-console/en/api-keys/)
2. 新建一个密钥，或复制一个已有的。
3. 把密钥安全保管好（环境变量、密钥管理服务等）。


> **环境变量示例**（按您的部署方式调整）：`YOUR_API_KEY=your‑api‑key`


#### 3. 配置 MCP 配置 JSON 文件

MCP 客户端读取的 JSON 配置文件名为 `mcp.json`。按下示例为 YouCam MCP 服务器加一条记录：

* YouCam for Beauty & Skin Care（美妆与护肤）


```json
{
  "mcpServers": {
    "youcam-beauty": {
      "url": "https://mcp-api-01.makeupar.com/mcp/beauty",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

* YouCam for Fashion & Retail（服饰与零售）


```json
{
  "mcpServers": {
    "youcam-fashion": {
      "url": "https://mcp-api-01.makeupar.com/mcp/fashion",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

* YouCam for Creators（创作者）


```json
{
  "mcpServers": {
    "youcam-creators": {
      "url": "https://mcp-api-01.makeupar.com/mcp/creators",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

**配置步骤**

| 步骤 | 操作 |
|  --- | --- |
| **1. 建立 MCP 配置 JSON 文件** | 把文件放在项目根目录，或放在各客户端专用的配置目录（参见对应客户端的文档）。 |
| **2. 替换占位符** | 把 `YOUR_API_KEY` 换成第 2 节里拿到的值；若客户端支持，也可引用环境变量（`${YOUR_API_KEY}`）。 |
| **3. 验证连通性** | 打开客户端界面，确认 «YouCam API MCP» 已作为可选服务出现。 |


> 配置是静态的；换了密钥需要重载客户端。


## MCP 客户端设置

**与主流支持 MCP 的客户端集成**

#### Claude 桌面版

1. 下载并安装 [Node.js 与 npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)。
2. Settings → Developer → Edit config → 打开 claude_desktop_config.json 文件
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/claude_mcp_config1_8142d700d0.png)
3. 更新 `mcpServers` 这一段
4. 把 `YOUR_API_KEY` 换成您真实的 API 密钥


```json
{
  "mcpServers": {
    "youcam-beauty": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-api-01.makeupar.com/mcp/beauty",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

1. **File → Exit**，重启 Claude 桌面版


#### Cursor

1. 打开 Settings → Tools & MCP → Add Custom MCP
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/cursor_mcp_config2_9f31015370.png)
2. 把配置写进 mcp.json 文件


```json
{
  "mcpServers": {
    "youcam-beauty": {
      "url": "https://mcp-api-01.makeupar.com/mcp/beauty",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

1. 进入 Cursor Settings → Tools & MCP
2. 在 'Installed MCP Servers' 区块里启用或停用想要的工具


#### Copilot in VS Code（Visual Studio Code）

**Copilot in VS Code 方案一：**

1. `> MCP: Add Server`
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/vscode_mcp_setting1_b1f041a72a.png)
2. 选 `HTTP`
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/vscode_mcp_setting2_e1d82b494c.png)
3. 填入服务器 URL
4. 给这个 mcp 服务器起个名字
5. 请求头设置：填上 API token


**Copilot in VS Code 方案二：**

1. `> MCP: Open User Configuration`
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/vscode_config_img_34fe410c06.png)
2. 把 youcam-beauty 的配置更新到 `mcp.json`


```json
{
    "servers": {
        "youcam-beauty": {
            "url": "https://mcp-api-01.makeupar.com/mcp/beauty",
            "type": "http",
            "headers": {
                "Authorization": "Bearer YOUR_API_KEY"
            }
        }
    }
}
```

## MCP 能力一览

### YouCam for Beauty & Skin Care（美妆与护肤）

YouCam for Beauty & Skin Care 提供下面这些工具，覆盖美妆、护肤分析、面部美化与形象改造：

* YouCam for Beauty & Skin Care（美妆与护肤）


```json
{
  "mcpServers": {
    "youcam-beauty": {
      "url": "https://mcp-api-01.makeupar.com/mcp/beauty",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

#### 面部与肤质分析 / 美化

| 工具名 | 说明 |
|  --- | --- |
| `AI_Skin_Analysis` | 评估皱纹、毛孔、痘痘、出油、黑眼圈、肤质、水润度等肌肤困扰（支持高清与标清两种模式）。 |
| `AI_Skin_simulation` | 针对最多 10 项肌肤困扰（光泽、痘痘、斑点等），可视化调理前后的变化过程。 |
| `AI_Facial_Color_Tones_Analyzer` | 检测面部肤色、瞳色、眉色、唇色与发色。 |
| `AI_Aging_Simulation` | 一张自拍，生成从年轻到年老的系列照片，看自己各年龄段的样子。 |
| `AI_Face_Attributes_and_Ratio_Analyzer` | 分析面部结构、五官（眼、眉、唇、鼻、颧骨）以及黄金比例。 |
| `AI_Face_Lift` | 用 AI 做面部精修，针对眼袋、苹果肌、额头、脸型、嘴部，效果自然。 |
| `AI_Face_Reshape` | 精细到像素地调整眼睛、鼻子、嘴唇、下颌线、下巴和整体脸型。 |
| `AI_Fitzpatrick_Skin_Type_Analysis` | 依据黑色素水平与紫外线反应，把肤质归入 6 种Fitzpatrick类型。 |
| `AI_Smile` | 把面无表情或沮丧的表情变成自然的笑容（可带牙可不带牙）。 |
| `AI_Teeth_Whitening` | 自动检测并提亮牙齿，美白强度可调。 |


#### 发型与头发分析

| 工具名 | 说明 |
|  --- | --- |
| `AI_Hair_Style_Virtual_Try_On` | 用模板或参考图，试换各种发型（卷发、长发、寸头等）。 |
| `AI_Hair_Type_Detection` | 分析头发纹理、粗细与卷曲度，清楚归入 9 种发质类型。 |
| `AI_Hair_Volume_Virtual_Try_On` | 照片里头发细软、稀疏？一键加上自然蓬松感。 |
| `AI_Bangs_Filter_Virtual_Try_On` | 虚拟试换不同刘海，看哪种最衬您的脸。 |
| `AI_Hair_Color_Virtual_Try_On` | 用预设配色或自定义色板换发色（全头或渐层模式）。 |
| `AI_Wavy_Hair_Virtual_Try_On` | 虚拟尝试波浪卷、大卷、螺旋卷等发型。 |
| `AI_Hair_Density_Detection` | 按头皮可见度评估发量密度，分为 4 个等级。 |
| `AI_Hair_Extension_Virtual_Try_On` | 虚拟试接长发到超长发，过渡自然不突兀。 |
| `AI_Hair_Frizziness_Detection` | 用正面、左侧、右侧三个角度的照片分析头发毛躁程度。 |
| `AI_Hair_Length_Detection` | 测量头发长度，归入 5 个明确阶段。 |


#### 身形与健身

| 工具名 | 说明 |
|  --- | --- |
| `AI_Abs_Filter` | 在全身/上半身照片上加出逼真的六块腹肌与马甲线。 |
| `AI_Body_Reshape` | 瘦身、塑形、优化身材比例（腰、手臂、大腿、胸、身高等）。 |
| `AI_Breast_Augmentation_Simulator` | 无创的 AI 可视化胸部轮廓增强，强度可调。 |


#### 美妆与虚拟试穿

| 工具名 | 说明 |
|  --- | --- |
| `AI_Makeup_Virtual_Try_On` | 超写实的虚拟化妆，粉底、腮红、眼影、唇色等都能精细控制。 |
| `AI_Makeup_Transfer` | 把参考照里的整套妆容，迁移到目标自拍上。 |
| `AI_Nail_Virtual_Try_On` | 虚拟试戴甲油色、质地、图案，以及穿戴甲。 |
| `AI_Eye_Color_Lens_Virtual_Try_On` | 逼真的美瞳/瞳色虚拟模拟，透明度与融合度可调。 |
| `AI_Look_Virtual_Try_On` | 通过模板，一键套用专业设计的整体妆容与面部造型。 |
| `AI_Beard_Style_Generator` | 虚拟试换男士胡型生成器（短胡茬、浓密、山羊胡、小胡子等）。 |


#### 工具、模板与任务管理

| 工具名 | 说明 |
|  --- | --- |
| `*_Templates` | 列出刘海、胡子、接发、发型、头发蓬松、整体妆效等预置模板。 |
| `*_Detection` | 运行部分塑形/提升/美白接口前置的检测与预处理任务。 |
| `File_Upload` | 交互式拖拽上传控件，直接从浏览器上传图片和视频。 |
| `Get_Running_Task_Status` | 查看此前启动的 AI 处理任务的状态并取回结果。 |
| `Get_Upload_API_Info` | 给出指定任务类型的上传接口地址与请求/响应示例。 |
| `Get_Feature_Cost` | 查询每个 YouCam API 功能的点数消耗与定价。 |


### YouCam for Fashion & Retail（服饰与零售）

YouCam for Fashion & Retail 提供下面这些 API 工具，用于服饰、配饰与造型类应用：

* YouCam for Fashion & Retail（服饰与零售）


```json
{
  "mcpServers": {
    "youcam-fashion": {
      "url": "https://mcp-api-01.makeupar.com/mcp/fashion",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

#### 服装与面料

| 工具名 | 说明 |
|  --- | --- |
| `AI_Clothes_Virtual_Try_On` | 虚拟试衣间，把服装叠到您的照片上。支持全身、上半身/下半身、鞋、外套，或自动识别。 |
| `AI_Fabric_Virtual_Try_On` | 用预置模板（如真丝、醒目花色）把真实的面料纹理与印花贴到图片上。 |
| `AI_Fabric_Virtual_Try_On_Templates` | 列出所有可用的预置面料纹理/样式模板，供 AI 面料虚拟试穿工具使用。 |


#### 鞋子

| 工具名 | 说明 |
|  --- | --- |
| `AI_Shoes_Virtual_Try_On` | 高保真的 AR 试鞋，在您脚上呈现合脚度、款式与颜色。需显式传 `gender` 参数。 |


#### 帽子与围巾

| 工具名 | 说明 |
|  --- | --- |
| `AI_Hat_Virtual_Try_On` | 超写实的 AR 试戴帽子、棒球帽、发带，贴合精准、样式可控。需显式传 `gender` 参数。 |
| `AI_Scarf_Virtual_Try_On` | 模拟围巾在衣服上的自然垂坠、褶皱与花纹走向。需显式传 `gender` 参数。 |


#### 珠宝与配饰

| 工具名 | 说明 |
|  --- | --- |
| `AI_Bracelet_Virtual_Try_On` | 一张 2D 图片即可 AI 试戴手链，位置、阴影、光照均可调。 |
| `AI_Earrings_Virtual_Try_On` | 逼真的耳环与虚拟打洞模拟，支持动态光照、遮挡处理与左右耳选择。 |
| `AI_Necklace_Virtual_Try_On` | AR 项链试戴，精准追踪颈部与锁骨，佩戴效果讲究、符合物理规律。 |
| `AI_Ring_Virtual_Try_On` | 虚拟试戴戒指/订婚戒指，可选手指、指节定位，阴影与光照逼真。 |
| `AI_Watch_Virtual_Try_On` | AR 手表可视化，支持表带对齐、表壳边缘识别与手腕定位。 |
| `AI_Bag_Virtual_Try_On` | 奢侈品手袋 AR 试背，呈现背法、肩带长度与穿搭搭配。需显式传 `gender` 参数。 |


#### 工具与任务管理

| 工具名 | 说明 |
|  --- | --- |
| `File_Upload` | 交互式拖拽上传控件，直接从浏览器上传图片和视频。 |
| `Get_Running_Task_Status` | 查看此前启动的 AI 处理任务的状态并取回结果。 |
| `Get_Upload_API_Info` | 给出指定任务类型的上传接口地址与请求/响应示例。 |
| `Get_Feature_Cost` | 查询每个 YouCam API 功能的点数消耗与定价。 |


### YouCam for Creators（创作者）

YouCam for Creators 里这些 AI 驱动的工具，按主要用途分组：

* YouCam for Creators（创作者）


```json
{
  "mcpServers": {
    "youcam-creators": {
      "url": "https://mcp-api-01.makeupar.com/mcp/creators",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

#### AI 图片生成器与增强

| 工具名 | 说明 |
|  --- | --- |
| `AI_Image_Generator_Text_to_Image` | 由文字描述生成高质量图片，可控制风格与尺寸，并支持智能改写提示词。 |
| `AI_Image_Generator_Image_to_Image` | 按文字指令改造或编辑现有图片，最多可带 3 张参考图用于姿态/风格引导。 |
| `AI_Photo_Colorize` | 把黑白照、褪色老照片一键上色，给出 4 个风格各异、鲜活的版本（暖调到低温调）。 |
| `AI_Color_Correction` | 自动调节饱和度、色温、色相、曝光与肤色，输出 4 个专业调校版本。 |
| `AI_Photo_Enhance` | 提升分辨率（1x/2x/4x）、修复运动模糊、去除马赛克感，并锐化面部与细节清晰度。 |
| `AI_Photo_Lighting` | AI 提亮工具：救回暗部、平衡曝光，让暗光照片自然变亮。 |
| `AI_Image_Extender` | 懂上下文的扩图：按任意自定义比例无痕迹地扩展画面，风格与画质保持一致。 |


#### 背景处理

| 工具名 | 说明 |
|  --- | --- |
| `AI_Photo_Background_Removal` | 高精度 AI 抠图，边缘干净；支持人物、商品、动物、汽车等。 |
| `AI_Photo_Background_Blur` | 加上自然的虚化/背景模糊，让主体更突出；强度可调（0–100）。 |
| `AI_Photo_Background_Change` & `_Templates` | 抠出主体后，用自定义文字描述或预置风景模板替换背景。 |
| `AI_Video_Background_Replace` | 用参考图/参考视频无缝替换视频背景；支持裁切/拉伸两种适配方式。 |


#### 人像、头像与形象照

| 工具名 | 说明 |
|  --- | --- |
| `AI_Avatar_Generator` & `_Templates` | 图生图做头像：学习面部特征，再套用艺术化/风格化模板。 |
| `AI_Studio_Generator` & `_Templates` | 把日常自拍变成照相馆级专业人像，光线与构图自动优化。 |
| `AI_Headshot_Generator` & `_Templates` | 用普通照片生成体面的 LinkedIn/商务/模卡头像，套用 AI 造型模板。 |


#### 换脸与对象编辑

| 工具名 | 说明 |
|  --- | --- |
| `AI_Face_Swap` & `AI_Face_Swap_Face_Detection` | 超写实的照片换脸，支持多人脸、自定义对应关系和跳过逻辑。 |
| `AI_Video_Face_Swap` | AI 单人脸视频换脸，自适应光照、追踪表情、融合肤色。 |
| `AI_Object_Removal_Pro` | 用灰度蒙版精准移除多余的对象/路人，背景细节完好保留。 |
| `AI_Video_Object_Removal` | 用一张参考蒙版帧，逐帧一致地从视频里移除干扰元素。 |
| `AI_Replace` | AI 局部重绘：去掉蒙版区域，按自定义描述生成新的对象/纹理。 |


#### AI 视频生成器与增强

| 工具名 | 说明 |
|  --- | --- |
| `AI_Video_Generator_Text_to_Video` | 由文字描述生成动态视频，可控分辨率、宽高比、时长与反向提示词。 |
| `AI_Video_Generator_Image_to_Video` | 用运动提示词与模板优化，把静态图片变成逼真的短视频。 |
| `AI_Video_Enhancer` | 自动修糊、锐化边缘、校正曝光与亮度、降噪，并把低清素材放大到高清。 |
| `AI_Video_Style_Transfer` & `_Templates` | 逐帧套用电影感/AI 滤镜（波普、复古、动漫等），输出风格统一的视频。 |


#### 工具与任务管理

| 工具名 | 说明 |
|  --- | --- |
| `File_Upload` | 交互式拖拽上传控件，直接从浏览器上传图片和视频。 |
| `Get_Running_Task_Status` | 查看此前启动的 AI 处理任务的状态并取回结果。 |
| `Get_Upload_API_Info` | 给出指定任务类型的上传接口地址与请求/响应示例。 |
| `Get_Feature_Cost` | 查询每个 YouCam API 功能的点数消耗与定价。 |