Fattly 是一个 AI 内容生成平台，核心能力是让用户通过提示词创建图像、视频、配音、虚拟形象以及 UGC 广告。本仓库 fattly-mcp 是 Fattly 的官方 CLI 与 MCP 客户端，使用户可以从终端，或直接在 Claude、Cursor、VS Code 等 AI 助手中调用 Fattly 的生成功能。
主要能力方面，Fattly 将 50 多个 AI 模型整合到一个账户中，资料中列举的模型包括 Veo 3.1、Kling 3、Seedance、Nano Banana、GPT Image、ElevenLabs 等。用户可以用它把产品照片转成 UGC 视频广告，也可以生成 AI 图像、视频和配音。付费使用 fattly.app 的积分，积分不会过期。
使用方式上，该包本身是一个 MCP 服务器，允许 AI 助手通过用户的 FATTLY 账户生成媒体内容。接入方式有两种：
方式 A——托管模式（无需安装，使用 OAuth 登录）：将客户端连接到托管服务器，不需要 npm，也不需要粘贴密钥，在浏览器中批准访问即可。在 Claude 中的操作路径为：Settings → Connectors → Add custom connector → 粘贴 URL。完整设置指南见 https://fattly.app/claude-mcp。
方式 B——本地模式（使用 npx，需要 API key）：在 fattly.app 打开 Dashboard → API keys 创建一个密钥，然后将相应配置添加到客户端的 MCP 配置中。如果使用 AI 代理（Cline、Claude Code、Cursor）安装，可让其参考 llms-install.md。
该 MCP 服务器提供 21 个工具，与托管服务器相同。本地服务器会把每次调用连同密钥转发到 fattly.app，因此新工具无需更新包即可出现。每个工具都带有 MCP 注解（readOnlyHint、destructiveHint、idempotentHint），客户端可以在付费调用前先询问用户。生成失败会自动退款。内容必须符合安全规范（safe-for-work）。通过 fattly login 保存的密钥存放在 ~/.fattly/config.json，权限为仅所有者可访问。
适用场景包括：从终端批量或脚本化生成 AI 图像、视频、配音；在 AI 助手对话中直接生成媒体素材；将产品照片快速转化为 UGC 视频广告；以及需要统一调用多个主流生成模型的创作工作流。
限制与补充：网页应用还提供更多功能，例如支持 5 种语言的带唇形同步的 AI 配音、虚拟试穿、Cinema Studio。内容必须安全合规。关于具体价格、各模型详细参数、生成时长、分辨率等信息，资料中暂未提供。问题反馈可访问 https://github.com/industriesfatty-spec/fattly-mcp/issues。
