fattly

---

MCP（Claude、Cursor、VS Code）

此软件包是一个 MCP 服务，可让 AI 助手通过你的 FATTLY 账户生成媒体。

选项 A — 托管服务（无需安装，使用 OAuth 登录）

将客户端连接到托管服务。无需 npm，也无需粘贴密钥——在浏览器中批准访问即可。

https://fattly.app/api/mcp

在 Claude 中：Settings → Connectors → Add custom connector → 粘贴 URL。完整设置指南：https://fattly.app/claude-mcp

选项 B — 本地运行（npx，使用 API 密钥）

1. 在 fattly.app 中打开 Dashboard → API keys 并创建密钥。
2. 将以下内容添加到客户端的 MCP 配置中：

{
  "mcpServers": {
    "fattly": {
      "command": "npx",
      "args": ["-y", "fattly", "mcp"],
      "env": {
        "FATTLY_API_KEY": "gpx_live_YOUR_KEY"
      }
    }
  }
}

使用 AI Agent（Cline、Claude Code、Cursor）安装？请引导其参考 llms-install.md。

工具

共有 21 个工具——与托管服务的工具集相同（本地服务会使用你的密钥，将每次调用转发到 fattly.app，因此无需更新软件包即可使用新工具）。

工具	功能	消耗额度
广告工作室
fattly_generate_ad_video	UGC 视频广告：逼真的 AI 创作者出镜展示你的产品，并配有真实语音（也可选择仅展示双手的 POV 或开箱形式）	是（约 150）
fattly_generate_ad	根据产品照片生成广告图片：场景化产品图，或由创作者手持产品的图片	是（20）
fattly_create_avatar	创建专属且形象一致的 AI 创作者，用于广告	是（20）
fattly_list_ad_presets	广告预设、场景和创作者虚拟形象	否（只读）
图片
fattly_generate_image	文本生成图片和图片编辑（支持编辑多张图片）	是
fattly_upscale	放大图片	是
fattly_remove_background	干净地抠出图像并去除背景	是
fattly_inpaint	根据提示词重绘蒙版区域	是
fattly_face_swap	替换人脸（仅限适宜工作场合的内容，且仅可使用你有权使用的人脸）	是
视频
fattly_generate_video	文本生成视频和图片生成视频（Veo、Kling、Seedance 等）	是
fattly_video_status	检查仍在渲染的视频	否（只读）
fattly_animate_photo	让静态照片动起来	是
fattly_trend_video	根据照片和预设生成潮流风格视频	是
fattly_edit_video	Draw-to-Edit：通过文本修改视频中的蒙版区域	是
fattly_actor_swap	替换现有视频中的创作者	是
音频
fattly_generate_audio	配音（文本转语音）或音乐	是
fattly_clone_voice	克隆语音（需获得同意）或重复使用已保存的语音	是
fattly_transcribe	将音频转换为带时间标记的文本片段	是
账户
fattly_credits	当前额度余额	否（只读）
fattly_list_models	模型及其额度价格	否（只读）
fattly_upload_image	照片（URL、base64 或本地文件）→ 用于编辑、广告或图片生成视频工具的 URL	否

每个工具都带有 MCP 注解（readOnlyHint、destructiveHint、idempotentHint），因此客户端可在付费调用前征求确认。生成失败时会自动退款。内容必须适合工作场合。

命令行工具

npm install -g fattly   # Node.js 18+
fattly login            # paste your gpx_live_… key

fattly credits
fattly models video

fattly generate "astronaut cat on Mars" --model nano-banana-2 --out cat.png
fattly video "ocean waves at sunset" --model kling-3-standard --out waves.mp4
fattly audio "Welcome to FATTLY" --voice Rachel --out voice.mp3
fattly audio "calm ambient" --music --seconds 30 --out music.mp3

配置

变量	用途
FATTLY_API_KEY	API 密钥（可替代 fattly login）
FATTLY_API_URL	API 地址覆盖项（默认值为 https://fattly.app）

fattly login 保存的密钥位于 ~/.fattly/config.json，仅所有者可访问。

更多信息

• 网站：https://fattly.app
• Web 应用中还有更多功能：支持 5 种语言的 AI 配音和口型同步、虚拟试穿、Cinema Studio。
• 问题反馈：https://github.com/industriesfatty-spec/fattly-mcp/issues

MIT © Fattly