Mcp Face Transform

io.github.AceDataCloudv2026.9.29.0更新于 Sep 30, 2026

AceDataCloud Face Transform MCP: keypoints, beautify, age/gender, swap, cartoon, liveness

已验证Streamable HTTP可网页运行Other

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Face Transform，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "mcp-face-transform": {
      "type": "http",
      "url": "https://face.mcp.acedata.cloud/mcp"
    }
  }
}

README

MCP Face Transform Server

A Model Context Protocol (MCP) server that exposes the AceDataCloud Face Transform API — face keypoint detection, beautification, age/gender transform, face swap, cartoonization, and liveness detection.

Status: All Face APIs are currently in Alpha. Interfaces may evolve.

Features

  • Keypoint detection — 90+ landmarks per face, multi-face supported
  • Beautification — smoothing, whitening, face slimming, eye enlarging
  • Age transform — age or de-age a portrait
  • Gender transform — swap perceived facial gender characteristics
  • Face swap — move a source face onto a target image (with optional async webhook)
  • Cartoonize — render a portrait in animated / cartoon style
  • Liveness detection — distinguish live captures from printed / screen photos

Installation

bash
pip install mcp-face-transform

Configuration

Set your AceDataCloud API token:

bash
export ACEDATACLOUD_API_TOKEN=your_token_here

Get your token from https://platform.acedata.cloud.

Usage

stdio mode (default)

bash
mcp-face-transform

HTTP mode

bash
mcp-face-transform --transport http --port 8000

Tool Reference

ToolDescription
face_detect_keypointsDetect 90+ keypoints per face (multi-face supported).
face_beautifySmoothing, whitening, face slimming, and eye enlarging.
face_change_ageAge or de-age a portrait.
face_change_genderSwap perceived facial gender characteristics.
face_swapMove a source face onto a target image (with optional async webhook).
face_cartoonizeRender a portrait in cartoon / animated style.
face_detect_livenessDistinguish a live capture from a printed / screen photo.
face_get_usage_guideConcise client-side tool usage reference.

Example

text
"Detect all faces in https://example.com/group.jpg and return their keypoints."→ face_detect_keypoints(image_url="https://example.com/group.jpg")
"Lighten and smooth my portrait."→ face_beautify(image_url="https://example.com/me.jpg", smoothing=15, whitening=25)
"Replace the face in the scene with the headshot."→ face_swap(    source_image_url="https://example.com/headshot.jpg",    target_image_url="https://example.com/scene.jpg",  )

Configuration in Claude Desktop / Claude Code

json
{  "mcpServers": {    "face-transform": {      "command": "uvx",      "args": ["mcp-face-transform"],      "env": {        "ACEDATACLOUD_API_TOKEN": "your_api_token_here"      }    }  }}

Or use the hosted endpoint with bearer auth:

json
{  "mcpServers": {    "face-transform": {      "url": "https://face.mcp.acedata.cloud/mcp",      "headers": {        "Authorization": "Bearer your_api_token_here"      }    }  }}

Development

bash
pip install -e ".[dev,test]"pytest --cov=core --cov=toolsruff check .

Service details

Service details

License

MIT — see LICENSE.

来源：README.md，提交 f237b31

工具

0
工具元数据尚未被收录。

版本历史

2
  1. v2026.9.29.0最新Sep 29, 2026
  2. v2026.8.23.0Sep 16, 2026