跳转到内容
/
MCP
最后更新于

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/
  2. 新建一个密钥，或复制一个已有的。
  3. 把密钥安全保管好（环境变量、密钥管理服务等）。

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

3. 配置 MCP 配置 JSON 文件

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

  • YouCam for Beauty & Skin Care（美妆与护肤）
{
  "mcpServers": {
    "youcam-beauty": {
      "url": "https://mcp-api-01.makeupar.com/mcp/beauty",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
  • YouCam for Fashion & Retail（服饰与零售）
{
  "mcpServers": {
    "youcam-fashion": {
      "url": "https://mcp-api-01.makeupar.com/mcp/fashion",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
  • YouCam for Creators（创作者）
{
  "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。

  2. Settings → Developer → Edit config → 打开 claude_desktop_config.json 文件

  3. 更新 mcpServers 这一段

  4. 把 YOUR_API_KEY 换成您真实的 API 密钥

{
  "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

  2. 把配置写进 mcp.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

  2. 选 HTTP

  3. 填入服务器 URL

  4. 给这个 mcp 服务器起个名字

  5. 请求头设置：填上 API token

Copilot in VS Code 方案二：

  1. > MCP: Open User Configuration

  2. 把 youcam-beauty 的配置更新到 mcp.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（美妆与护肤）
{
  "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（服饰与零售）
{
  "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_OnAR 项链试戴，精准追踪颈部与锁骨，佩戴效果讲究、符合物理规律。
AI_Ring_Virtual_Try_On虚拟试戴戒指/订婚戒指，可选手指、指节定位，阴影与光照逼真。
AI_Watch_Virtual_Try_OnAR 手表可视化，支持表带对齐、表壳边缘识别与手腕定位。
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（创作者）
{
  "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_LightingAI 提亮工具：救回暗部、平衡曝光，让暗光照片自然变亮。
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_SwapAI 单人脸视频换脸，自适应光照、追踪表情、融合肤色。
AI_Object_Removal_Pro用灰度蒙版精准移除多余的对象/路人，背景细节完好保留。
AI_Video_Object_Removal用一张参考蒙版帧，逐帧一致地从视频里移除干扰元素。
AI_ReplaceAI 局部重绘：去掉蒙版区域，按自定义描述生成新的对象/纹理。

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 功能的点数消耗与定价。

Skills 技能包

CLI 命令行