Codex CLI 对接 Face Transform 面部转换 MCP
内容提要
本文介绍如何将AceData Cloud的Face Transform MCP服务器接入Codex CLI，实现面部识别与处理功能。通过配置config.toml文件，用户可在对话中直接调用7项能力：关键点检测、美颜、年龄/性别变换、换脸、卡通化和活体检测，无需切换窗口。文章提供了配置步骤、使用示例及工具说明。
延伸解读
配置要点与注意事项
接入过程只需在 config.toml 中添加一个 MCP 服务器配置，并填入从 AceData Cloud 获取的 API Token。注意该 Token 是访问所有 AceData Cloud MCP 服务的凭证，需妥善保管。配置保存后，需重启 Codex 会话才能加载新工具。若配置无效，可检查 URL 和 Authorization 头格式是否正确。
能力覆盖与使用场景
Face Transform MCP 提供 7 项面部处理能力，涵盖关键点检测、美颜、年龄/性别变换、换脸、卡通化和活体检测。这些能力可直接在对话中调用，适合需要快速处理图像而无需切换工具的场景。例如，可用 face_beautify 调整磨皮和瘦脸参数，或用 face_swap 实现两张图之间的人脸转移。
局限性提示
文章未提及各项能力的精度、处理速度或对图片格式、大小的限制。实际效果可能受输入图像质量影响，尤其是换脸和年龄变换功能。此外，活体检测的可靠性未在文中说明，若用于安全验证需谨慎评估。建议在正式使用前，先用示例图片测试各项功能的效果。
Q&A
如何将 Face Transform MCP 服务器配置到 Codex CLI 中？
编辑 ~/.codex/config.toml 文件，添加如下配置： [mcp_servers.face] url = "https://face.mcp.acedata.cloud/mcp" type = "http" http_headers = { "Authorization" = "Bearer 你的Token" } 保存后，下次启动 codex 会话时自动加载工具。
Face Transform MCP 提供哪些面部处理能力？
提供 7 项能力：关键点检测、美颜、年龄变换、性别变换、换脸、卡通化和活体检测。
在 Codex CLI 中如何使用 face_beautify 工具进行美颜？
在对话中直接输入类似“用 face_beautify 给这张人像做美颜：磨皮 30、瘦脸 50”的指令，Codex CLI 会调用该工具处理图片。
如何获取 AceData Cloud 的 API Token？
到 AceData Cloud 平台注册账号，然后复制首页的 API Token。一个 Token 即可使用全部 AceData Cloud MCP Server。
Face Transform MCP 的 URL 是什么？
URL 是 https://face.mcp.acedata.cloud/mcp。
使用 Face Transform MCP 需要切换窗口吗？
不需要。通过 MCP 接入 Codex CLI 后，可以直接在对话中调用，不用切换窗口、不用复制粘贴。
