Repository navigation
Add Face Transform plugin #556
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
acedatacloud-dev
wants to merge
4
commits into
cursor:main
Choose a base branch
from
AceDataCloud:codex/face-transform-plugin
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+213
−0
Open
Changes from all commits
Commits
Show all changes
4 commits
Select commit
Hold shift + click to select a range
c671840
feat(third_party): add Face Transform plugin
acedatacloud-dev 1b85d08
fix(face-transform): declare API token variable
acedatacloud-dev b1f03ba
docs: match Cursor 3.24 plugin navigation
acedatacloud-dev 54de413
docs: tag shared Cursor README activation links
acedatacloud-dev File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,44 @@ | ||
| { | ||
| "name": "face-transform", | ||
| "displayName": "Face Transform", | ||
| "version": "1.0.0", | ||
| "minClientVersions": { | ||
| "cursor": "3.13.0" | ||
| }, | ||
| "description": "Analyze and transform faces through Ace Data Cloud.", | ||
| "author": { | ||
| "name": "Ace Data Cloud Dev", | ||
| "email": "[email protected]" | ||
| }, | ||
| "homepage": "https://platform.acedata.cloud/models", | ||
| "repository": "https://github.com/AceDataCloud/FaceTransformCursor", | ||
| "license": "MIT", | ||
| "logo": "assets/logo.svg", | ||
| "keywords": [ | ||
| "face-transform", | ||
| "face transform", | ||
| "face analysis", | ||
| "acedatacloud", | ||
| "mcp" | ||
| ], | ||
| "category": "integrations", | ||
| "tags": [ | ||
| "face-transform", | ||
| "face analysis", | ||
| "mcp" | ||
| ], | ||
| "variables": { | ||
| "type": "object", | ||
| "properties": { | ||
| "ACEDATACLOUD_API_TOKEN": { | ||
| "type": "string", | ||
| "title": "Ace Data Cloud API token", | ||
| "description": "Service API key from https://platform.acedata.cloud/console/applications with Face Transform access." | ||
| } | ||
| }, | ||
| "required": [ | ||
| "ACEDATACLOUD_API_TOKEN" | ||
| ] | ||
| }, | ||
| "mcpServers": "./mcp.json" | ||
| } | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,5 @@ | ||
| # Changelog | ||
|
|
||
| ## 1.0.0 | ||
|
|
||
| - Initial Face Transform Cursor plugin using the existing Ace Data Cloud hosted MCP. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,21 @@ | ||
| MIT License | ||
|
|
||
| Copyright (c) 2026 Ace Data Cloud | ||
|
|
||
| Permission is hereby granted, free of charge, to any person obtaining a copy | ||
| of this software and associated documentation files (the "Software"), to deal | ||
| in the Software without restriction, including without limitation the rights | ||
| to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
| copies of the Software, and to permit persons to whom the Software is | ||
| furnished to do so, subject to the following conditions: | ||
|
|
||
| The above copyright notice and this permission notice shall be included in all | ||
| copies or substantial portions of the Software. | ||
|
|
||
| THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
| IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
| FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
| AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
| LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
| OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | ||
| SOFTWARE. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,57 @@ | ||
| # Face Transform for Cursor | ||
|
|
||
| Analyze and transform faces through Ace Data Cloud. This standalone plugin reuses the [Ace Data Cloud face MCP](https://github.com/AceDataCloud/MCPs/tree/main/face) and includes a focused Agent skill. Available tools and limits come from the live MCP schema. | ||
|
|
||
| [简体中文教程](readme/README_zh_Hans.md) · [Copyable first-run prompt](examples/first-run.md) · [Current pricing](https://platform.acedata.cloud/models?utm_source=opensource&utm_medium=referral&utm_campaign=evergreen&utm_content=face_transform_cursor_shared_readme_pricing_en) | ||
|
|
||
| ## 1. Search and install | ||
|
|
||
| In Cursor 3.24, open **Customize → Browse Marketplace**, search for **Face Transform**, confirm **Ace Data Cloud Dev** and the service logo, then click **Add**. Older releases may put Plugins under Settings. You can also use `/add-plugin face-transform` in chat. If the official listing is not live, review this source under `~/.cursor/plugins/local/face-transform/`; local installation does not prove Marketplace publication. | ||
|
|
||
| ## 2. Get a service API key | ||
|
|
||
| 1. Sign in at [Ace Data Cloud Applications](https://platform.acedata.cloud/console/applications?utm_source=opensource&utm_medium=referral&utm_campaign=evergreen&utm_content=face_transform_cursor_shared_readme_api_key_en). | ||
| 2. Open **General application** or a service-specific application. Copy an existing API key, or use **Manage Keys → Create** for a separate Cursor key. | ||
| 3. Confirm Face Transform access, [current price](https://platform.acedata.cloud/models?utm_source=opensource&utm_medium=referral&utm_campaign=evergreen&utm_content=face_transform_cursor_shared_readme_pricing_en), and balance. If **Allowed APIs** restrictions are enabled, include /face/analyze. | ||
|
|
||
| Use a service API key, not a platform management token. Do not put it in chat or source files. | ||
|
|
||
| ## 3. Configure the plugin | ||
|
|
||
| Open **Customize → Plugins → Face Transform → Configure**, paste the key string into **Ace Data Cloud API token**, and click **Save**. Cursor uses it as `ACEDATACLOUD_API_TOKEN`; the plugin adds `Bearer `. Reconnect the MCP server if tools are missing. The hosted endpoint needs no local Python installation. | ||
|
|
||
| ```json | ||
| { | ||
| "mcpServers": { | ||
| "face": { | ||
| "type": "http", | ||
| "url": "https://face.mcp.acedata.cloud/mcp", | ||
| "headers": { | ||
| "Authorization": "Bearer ${ACEDATACLOUD_API_TOKEN}" | ||
| } | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| Use only images you have permission to process. The example is an existing public fictional test image. | ||
|
|
||
| ## 4. Run the first example | ||
|
|
||
| Open Cursor Agent and paste the [first-run prompt](examples/first-run.md). It asks for `face_detect_keypoints`, mode 1. The sample image_url is `https://platform2.cdn.acedata.cloud/seedream/00355681-7e81-49a4-a8fc-d2165fe1e9fd.jpg`. Verify service access and price before running. | ||
|
|
||
| Call `face_detect_keypoints` once and inspect the returned face analysis. This synchronous operation has no task ID to poll. | ||
|
|
||
| Inspect the returned keypoint data for the supplied image. In **Ace Data Cloud → Usage/Billing**, match this call to its deducted Credits record. The plugin is free; API calls follow current service pricing. | ||
|
|
||
| ## Troubleshooting | ||
|
|
||
| | Symptom | Action | | ||
| | --- | --- | | ||
| | Plugin or tools are missing | Check the Face Transform listing, configure the key, and reconnect MCP. | | ||
| | 401 or 403 | Check key validity, service access, balance, and Allowed APIs; do not include `Bearer ` in the configured value. | | ||
| | Invalid model or argument | Use the live tool schema and a model this account can access. | | ||
| | 429, timeout, or 5xx | Inspect the original task and usage history before another paid submission. | | ||
| | Empty or unexpected face result | Check that the image URL is reachable and contains a clear consenting adult face. | | ||
|
|
||
| [Source](https://github.com/AceDataCloud/FaceTransformCursor) · [Report a problem](https://github.com/AceDataCloud/FaceTransformCursor/issues) · [email protected]. The logo reuses an existing Ace Data Cloud integration asset. This tool plugin does not register a Cursor chat-model provider. |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,5 @@ | ||
| # First Face Transform run | ||
|
|
||
| Copy this into Cursor Agent after installing and configuring the plugin. No key is included. | ||
|
|
||
| > Use the face MCP tool face_detect_keypoints for one face analysis request. I checked the current Ace Data Cloud price and balance. Set mode 1. Set image_url to https://platform2.cdn.acedata.cloud/seedream/00355681-7e81-49a4-a8fc-d2165fe1e9fd.jpg. Run once, inspect the returned result or error, and do not repeat the call automatically. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| { | ||
| "mcpServers": { | ||
| "face": { | ||
| "type": "http", | ||
| "url": "https://face.mcp.acedata.cloud/mcp", | ||
| "headers": { | ||
| "Authorization": "Bearer ${ACEDATACLOUD_API_TOKEN}" | ||
| } | ||
| } | ||
| } | ||
| } |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,43 @@ | ||
| # Cursor Face Transform 插件 | ||
|
|
||
| Analyze and transform faces through Ace Data Cloud. 插件复用 [Ace Data Cloud face MCP](https://github.com/AceDataCloud/MCPs/tree/main/face),并提供专用 Agent skill。实际工具参数和限制以在线 MCP schema 为准。 | ||
|
|
||
| [English guide](../README.md) · [可复制的首跑提示词](../examples/first-run.md) · [当前价格](https://platform.acedata.cloud/models?utm_source=opensource&utm_medium=referral&utm_campaign=evergreen&utm_content=face_transform_cursor_shared_readme_pricing_zh_hans) | ||
|
|
||
| ## 1. 搜索安装 | ||
|
|
||
| 在 Cursor 3.24 打开 **Customize → Browse Marketplace**,搜索 **Face Transform**,确认作者 **Ace Data Cloud Dev** 和服务图标后点击 **Add**。较早版本可能在 Settings 中提供 Plugins 入口。也可在聊天中输入 `/add-plugin face-transform`。若官方条目尚未出现,可在 `~/.cursor/plugins/local/face-transform/` 本地审查;本地安装不代表 Marketplace 已上架。 | ||
|
|
||
| ## 2. 获取服务 API Key | ||
|
|
||
| 1. 登录 [Ace Data Cloud 应用管理](https://platform.acedata.cloud/console/applications?utm_source=opensource&utm_medium=referral&utm_campaign=evergreen&utm_content=face_transform_cursor_shared_readme_api_key_zh_hans)。 | ||
| 2. 打开 **General application** 或服务专用应用,复制已有 Key;也可通过 **Manage Keys → Create** 新建 Cursor 专用 Key。 | ||
| 3. 确认 Face Transform 权限、[当前价格](https://platform.acedata.cloud/models?utm_source=opensource&utm_medium=referral&utm_campaign=evergreen&utm_content=face_transform_cursor_shared_readme_pricing_zh_hans)和余额。若启用了 **Allowed APIs**,允许 /face/analyze。 | ||
|
|
||
| 使用服务 API Key,不要用平台管理 token,也不要放在聊天或仓库文件中。 | ||
|
|
||
| ## 3. 配置插件 | ||
|
|
||
| 打开 **Customize → Plugins → Face Transform → Configure**,将 Key 原文填入 **Ace Data Cloud API token** 并点击 **Save**。Cursor 将其用于 `ACEDATACLOUD_API_TOKEN`;插件会自行添加 `Bearer `,连接 `https://face.mcp.acedata.cloud/mcp`;无需安装本地 Python 服务。工具未出现时重新连接 MCP。 | ||
|
|
||
| Use only images you have permission to process. The example is an existing public fictional test image. | ||
|
|
||
| ## 4. 首次调用 | ||
|
|
||
| 在 Cursor Agent 中复制[首跑提示词](../examples/first-run.md)。它使用 `face_detect_keypoints`,参数为 mode 1,image_url 为 `https://platform2.cdn.acedata.cloud/seedream/00355681-7e81-49a4-a8fc-d2165fe1e9fd.jpg`。执行前核对当前模型权限和价格;字段变化时以在线工具 schema 为准。 | ||
|
|
||
| 调用一次 `face_detect_keypoints` 并检查返回的face analysis。这是同步操作,没有需要轮询的 task ID。 | ||
|
|
||
| 检查所给图片的关键点数据。在 **Ace Data Cloud → Usage/Billing** 核对本次调用对应的 Credits 扣费;插件免费,API 按当前服务价格计费。 | ||
|
|
||
| ## 排障 | ||
|
|
||
| | 现象 | 处理 | | ||
| | --- | --- | | ||
| | 找不到插件或工具 | 核对 Face Transform 条目、配置 Key 并重连 MCP。 | | ||
| | 401 或 403 | 检查 Key、服务权限、余额和 Allowed APIs;配置值不要带 `Bearer `。 | | ||
| | 模型或参数错误 | 以在线 MCP schema 和账户可用模型为准。 | | ||
| | 429、超时或 5xx | 先检查原任务和用量记录,再决定是否再次付费提交。 | | ||
| | 面部结果为空或异常 | 检查图片地址可访问且图片包含清晰、已获授权处理的成人面部。 | | ||
|
|
||
| [源码](https://github.com/AceDataCloud/FaceTransformCursor) · [问题反馈](https://github.com/AceDataCloud/FaceTransformCursor/issues) · [email protected]。图标复用 Ace Data Cloud 现有集成资源。本插件提供工具,不注册 Cursor 聊天模型 Provider。 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,14 @@ | ||
| --- | ||
| name: face-transform | ||
| description: Use Face Transform through the Ace Data Cloud MCP server in Cursor. Use for Face Transform face analysis work or an existing task query. | ||
| --- | ||
|
|
||
| # Face Transform in Cursor | ||
|
|
||
| This skill adapts the [existing Ace Data Cloud skill](https://github.com/AceDataCloud/Skills/tree/main/skills/face-transform). The live MCP schema is the source of truth for arguments and models. | ||
|
|
||
| 1. Check [current price, balance, and service access](https://platform.acedata.cloud/models) before a paid call. | ||
| 2. Call `face_detect_keypoints` once and inspect the returned face analysis. This synchronous operation has no task ID to poll. | ||
| 3. Return the result, task ID if present, and any service error. Keep the API token out of chat and files. | ||
|
|
||
| Configure `ACEDATACLOUD_API_TOKEN` in **Customize → Plugins → Face Transform → Configure**. See the [first-run guide](../../README.md). |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.