io.github.hanshs474/movoa-mcp
Movoa (movoa.ai), the AI video generator with sound: text and photo to video from any MCP client.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http movoa-mcp 'https://movoa.ai/api/mcp' --header 'Authorization: <Bearer sk-... from https://movoa.ai/settings/apikeys>'
{
"mcpServers": {
"movoa-mcp": {
"type": "http",
"url": "https://movoa.ai/api/mcp",
"headers": {
"Authorization": "<Bearer sk-... from https://movoa.ai/settings/apikeys>"
}
}
}
}
movoa-mcpclaude mcp add movoa-mcp -e 'MOVOA_API_KEY=<your movoa_api_key>' -- npx -y movoa-mcp@0.1.0
{
"mcpServers": {
"movoa-mcp": {
"command": "npx",
"args": [
"-y",
"movoa-mcp@0.1.0"
],
"env": {
"MOVOA_API_KEY": "<your movoa_api_key>"
}
}
}
}
متغيرات البيئة
MOVOA_API_KEYإلزامي سري API key from https://movoa.ai/settings/apikeys
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
Movoa MCP server
Unlimited AI video generator with sound: on paid plans the tenth take of a shot costs what the first did, and your first clip is free to make right now. This is the official MCP server for Movoa: it lets Claude, Cursor, Cline, Gemini CLI or any MCP client make video clips with sound on your own Movoa account. Ask for a clip in chat, get the file URL back.
- Text to video: describe the shot, and the sound comes back in the same file.
- Photo to video: pass a photo as
image_urland it becomes the first frame. - MiniMax H3 is the default model; Seedance 2.5, Seedance 2.0 (Fast, Mini) and Veo 3 Fast are there too. Every one of them returns AI video with audio.
Tools
| Tool | What it does |
|---|---|
generate_video | Text to video, or photo to video with image_url. Returns a run id (or waits with wait: true) |
check_status | Status of a run, and the video URL when it is ready |
credits | Credits left on your account (free to call) |
API key
Create one at movoa.ai/settings/apikeys and set it as MOVOA_API_KEY. Runs cost credits on your Movoa account, at the prices on movoa.ai/pricing.
Install
npx -y movoa-mcp
Claude Desktop / Claude Code / Cursor / Cline
{
"mcpServers": {
"movoa": {
"command": "npx",
"args": ["-y", "movoa-mcp"],
"env": { "MOVOA_API_KEY": "sk-..." }
}
}
}
Claude Code in one line: claude mcp add movoa -e MOVOA_API_KEY=sk-... -- npx -y movoa-mcp
Remote (Streamable HTTP, no install)
https://movoa.ai/api/mcp
Send your key with each request as Authorization: Bearer sk-.... Listing the tools needs no key; running one does. Claude Code: claude mcp add --transport http movoa https://movoa.ai/api/mcp --header "Authorization: Bearer sk-..."
Gemini CLI
gemini extensions install https://github.com/hanshs474/movoa-mcp
Claude Code plugin
claude plugin marketplace add hanshs474/movoa-mcp
claude plugin install movoa@movoa
The plugin also ships the movoa-video skill, which works without MCP (plain curl).
Models
model | Length (duration) | resolution | aspect_ratio |
|---|---|---|---|
minimax-h3 (default) | 4, 5, 6, 8, 10, 15 s | 480p, 768p | 16:9, 9:16, 1:1 |
seedance-2-5 | 5–30 s, steps of 5 | 480p, 720p | 16:9, 9:16, 1:1 |
veo-3-1-fast | 8 s | 720p | 16:9, 9:16 |
seedance-2 · seedance-2-fast · seedance-2-mini | 4, 6, 8, 10 s | 480p, 720p | 16:9, 9:16, 1:1 |
Notes
- Video takes minutes.
generate_videoreturns a run id by default; poll it withcheck_status, or passwait: trueto block (up to 30 minutes). - Your plan's concurrency limit applies; a submit past it is refused until a run finishes.
MOVOA_BASE_URLoverrides the endpoint; only useful against a local build of the site.
License
MIT
الأسئلة الشائعة
ما هو io.github.hanshs474/movoa-mcp؟
Movoa (movoa.ai), the AI video generator with sound: text and photo to video from any MCP client.
كيف أثبّت io.github.hanshs474/movoa-mcp؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http movoa-mcp 'https://movoa.ai/api/mcp' --header 'Authorization: <Bearer sk-... from https://movoa.ai/settings/apikeys>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.hanshs474/movoa-mcp إلى مفتاح API؟
نعم. يتطلب MOVOA_API_KEY, Authorization، وتضبطها في إعداداته.
هل io.github.hanshs474/movoa-mcp مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.hanshs474/movoa-mcp؟
ينشره hanshs474. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.