Fattly
fattly — FATTLY CLI
从终端生成 AI 图像、视频、配音、虚拟形象和 UGC 广告——或通过 MCP 从 Claude 和 Cursor 等 AI 助手生成。
30+ 个 AI 模型 · 使用你 fattly.app 账户中的积分。
安装
npm install -g fattly(需要 Node.js 18+。)
Related MCP server: mcp-media-engine
快速开始
打开网站 → 仪表盘 → API 密钥 → 生成密钥。
从终端登录:
fattly login
# paste your gpx_live_… key示例
fattly credits
fattly models
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.mp3MCP(Claude、Cursor)
同一个包也是一个 MCP 服务器——它让 AI 助手可以通过 FATTLY 生成内容。 有两种连接方式。
选项 A —— 托管(无需安装,通过 OAuth 登录)
最快的方式:将 Claude 直接连接到托管的 FATTLY MCP。无需 npm,无需粘贴密钥——你在浏览器中批准访问即可。
在 Claude 中 → 设置 → 连接器 → 添加自定义连接器,使用此 URL:
https://fattly.app/api/mcpClaude 会自动发现登录流程,并在 fattly.app 上打开一个同意页面;批准后工具即可就绪。使用你的 fattly.app 账户和积分。
选项 B —— 本地(npx,使用你的 API 密钥)
将此添加到你的客户端的 MCP 配置中:
{
"mcpServers": {
"fattly": {
"command": "npx",
"args": ["-y", "fattly", "mcp"],
"env": {
"FATTLY_API_KEY": "gpx_live_YOUR_KEY"
}
}
}
}可用工具:fattly_credits、fattly_list_models、fattly_generate_image、fattly_generate_video、fattly_generate_audio。
API 地址
默认情况下,CLI/MCP 连接到登录时设置的地址(或默认地址)。你可以在登录时覆盖它(fattly login --url https://your-domain),或使用 FATTLY_API_URL 环境变量。
Available Tools
6 toolsfattly_creditsCheck credit balanceARead-onlyIdempotentInspect
Shows the current credit balance on the FATTLY account. Read-only and free — call it before an expensive generation to make sure the user has enough credits.
Inputs: no named parameters.
fattly_generate_audioGenerate a voiceover or musicAInspect
Generates AI audio: a voiceover (mode=speech) from text, or music (mode=music) from a description. Returns a link to the mp3 file. Spends credits (price in fattly_list_models → audio); refunded automatically if the generation fails.
Inputs: mode (required), text (required), voice, seconds.
fattly_generate_imageGenerate an imageAInspect
Generates an AI image from a prompt (or edits uploaded images). Returns links to the finished images. Spends credits: model price × numImages (see fattly_list_models); fails with an error if the balance is too low, and credits are refunded automatically when a generation fails. Prompts must be safe-for-work.
Inputs: prompt (required), model, numImages, aspectRatio, +2 more.
fattly_generate_videoGenerate a videoAInspect
Generates an AI video from a prompt (or from a start image). Takes a few minutes — the tool waits (up to 10 min) and returns a link to the mp4 file. Video is the most expensive operation: it spends the model's credit price (see fattly_list_models), so confirm the model and cost with the user first. Credits are refunded automatically if the generation fails.
Inputs: prompt (required), model, duration, aspectRatio, +1 more.
fattly_list_modelsList models and pricesARead-onlyIdempotentInspect
Returns available models and their cost in credits (images, video, audio). Read-only and free. Use before generating to pick the right model id and to tell the user what a generation will cost.
Inputs: category.
fattly_upload_imageUpload a local imageAInspect
Uploads a local image file (JPG, PNG or WEBP) to FATTLY and returns a public fal URL. Use this to turn a photo on disk into an inputImageUrl for editing / face-swap / image-to-video models: pass the returned URL as inputImageUrl to fattly_generate_image or fattly_generate_video. No credits are charged for the upload.
Inputs: filePath (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct resource/action: credits, models, upload, image generation, video generation, audio generation. No two tools overlap in purpose; the generation tools are clearly separated by output modality.
All tools share the 'fattly_' prefix and use a consistent verb_noun pattern (list_models, upload_image, generate_image). The only minor deviation is 'fattly_credits' which is a noun rather than a verb_noun like 'get_credits' or 'check_credits'.
Six tools is well-scoped for a media generation server: one for account state, one for catalog/pricing, one for input preparation, and three for the core generation modalities. Each tool earns its place.
The core lifecycle is covered: check credits, list models, upload input, generate image/video/audio. Minor gaps exist (no tool to fetch a generation result by ID, no explicit cancel/delete), but the server's stated purpose of generating media is fully covered.
Maintenance
Related MCP Connectors
MCP server for Flux AI image generation
Generate AI images and videos from any compatible MCP client.
MCP server for Wan AI video generation
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server to use the fal.ai APIs to generate images and videos.36 PyPI4MIT
- AlicenseAqualityCmaintenanceMCP server for AI-powered image, audio, and video generation, enabling media creation directly from Claude, Cursor, and other MCP clients.1141 npmMIT
- AlicenseBqualityDmaintenanceMCP server for generating and editing images using OpenAI, and creating videos using OpenAI Sora and Google Veo. Enables fetching media from URLs or disk with smart output placement.149MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server for AI-powered image processing (generate, edit, vary, analyze) supporting OpenAI, Gemini, Ideogram, and custom relay endpoints.-