MCP server muapi-cli
Коммит 22 окт. 2026 г.Генерирует изображения, видео и аудио через терминал, используя различные AI-модели с помощью интерфейса командной строки.
Также известен как SamurAIGPT/muapi-cli
- Звёзды
- 19
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 22 окт. 2026 г.
- Лицензия
- —
Что такое muapi-cli MCP?
Генерирует изображения, видео и аудио через терминал, используя различные AI-модели с помощью интерфейса командной строки.
Сводка сгенерирована из README проекта
О muapi-cli MCP server
Этот интерфейс командной строки предоставляет прямой доступ к каталогу MuAPI для генерации мультимедийного контента. Он позволяет пользователям создавать изображения, видео и аудио в терминале, используя различные AI-модели. Инструмент разработан как для людей, которым удобен цветной вывод и таблицы, так и для AI агентов, которые могут использовать JSON-вывод, фильтрацию jq и семантические коды завершения.
Пользователи могут установить инструмент через npm или pip для локального управления рабочим процессом. Для работы требуется аккаунт MuAPI, который можно создать через регистрацию или настроив существующий API ключ. Интерфейс включает специализированные команды для различных типов медиа, таких как генерация изображений с flux-dev, создание видео с kling-master и производство аудио с помощью Suno. Помимо простой генерации, инструмент поддерживает расширенные задачи, такие как апскейлинг изображений, удаление фона и липсинк. Для разработчиков, которым требуется глубокая интеграция, инструмент позволяет запускать любую модель из каталога по имени её эндпоинта с помощью команды run, управляемой схемой.
Что вы можете с ним делать
- 1Генерация AI изображенийРазработчик может создать конкретный визуальный ассет, передав текстовый промпт такой модели, как flux-dev.
- 2Анимация статичных изображенийВы можете превратить неподвижное изображение в видео, передав URL в команду генерации видео.
- 3Автоматизация рабочих процессов агентовAI агенты могут обрабатывать результаты работы моделей, запрашивая данные в структурированном формате JSON.
- 4Улучшение существующего медиаконтентаПользователи могут выполнять вспомогательные задачи, такие как удаление фона или повышение качества изображений (апскейлинг).
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить muapi-cli MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка muapi-cli MCP в Claude Code
$ claude mcp add muapi-cli -- npx -y muapi-cliУстановка muapi-cli MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"muapi-cli": {
"command": "npx",
"args": [
"-y",
"muapi-cli"
]
}
}
}Установка muapi-cli MCP в VS Code
.vscode/mcp.json
{
"servers": {
"muapi-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"muapi-cli"
]
}
}
}Установка muapi-cli MCP в VS Code CLI
$ code --add-mcp '{"name":"muapi-cli","type":"stdio","command":"npx","args":["-y","muapi-cli"]}'Установка muapi-cli MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"muapi-cli": {
"command": "npx",
"args": [
"-y",
"muapi-cli"
]
}
}
}Установка muapi-cli MCP в Codex
$ codex mcp add muapi-cli -- npx -y muapi-cliУстановка muapi-cli MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.muapi-cli] command = "npx" args = ["-y", "muapi-cli"]
Установка muapi-cli MCP в Gemini CLI
$ gemini mcp add -s user muapi-cli npx -- -y muapi-cliУстановка muapi-cli MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"muapi-cli": {
"command": "npx",
"args": [
"-y",
"muapi-cli"
]
}
}
}Конфигурация
MUAPI_API_KEYNEW_KEYOLD_IDREQUEST_ID
| Название | Описание | Тип |
|---|---|---|
| MUAPI_API_KEY | — | |
| NEW_KEY | — | |
| OLD_ID | — | |
| REQUEST_ID | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийsamuraigpt/muapi-cli is public and reachablegithub.com/samuraigpt/muapi-cli ↗Пройдено
- Пакет указывает этот репозиторий как источникmuapi-cli names samuraigpt/muapi-cli as sourcenpmjs.com/package/muapi-cli ↗Пройдено
- Происхождение сборки (аттестация Sigstore)No build attestation published for this releaseНе проверялось
- Open source лицензия (OSI)No licenseПроблема
- Коммит или релиз за последний годLast commit or release 2026-10-22github.com/samuraigpt/muapi-cli ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from muapi-cliПройдено
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHubmuapi CLI
Official command-line interface for muapi.ai — generate images, videos, and audio directly from your terminal.
Agent-first design — every command works for both humans (colored output, tables) and AI agents (--output-json, --jq filtering, semantic exit codes, MCP server mode).
Related Projects
- MuAPI CLI docs — Command reference and setup guidance.
- MuAPI API reference — Underlying endpoints and prediction lifecycle.
- midjourney-api — Python SDK for Midjourney V7, V8, and Niji image generation.
- suno-api — Python SDK for Suno music, audio, and voice workflows.
- minimax-music-3-api — Python SDK for MiniMax Music 3.0 text-to-music generation on Muapi.
- awesome-minimax-music-3-prompts — Curated song prompts and lyrics-formatting guide for MiniMax Music 3.0.
- MiniMax-H3-API — Python SDK for MiniMax H3 video-generation workflows on Muapi.
- Seedance-2-Spicy-API — Python SDK and MCP server for the relaxed-moderation Seedance 2 Spicy / 2 Mini Spicy tier.
- Seedance-2.5-Spicy-API — Python SDK and MCP server for the relaxed-moderation Seedance 2.5 Spicy tier.
- Wan-3.0-Spicy-API — Python SDK and MCP server for the relaxed-moderation Wan 3.0 Spicy tier.
- awesome-minimax-h3-prompts — Prompt gallery with runnable MiniMax H3 examples for the CLI.
- Wan-3.0-API — Python SDK and MCP server for Wan 3.0-compatible AI video generation.
- Wan-3.0-Prime-API — Python SDK and MCP server for the higher-fidelity Wan 3.0 Prime tier.
- Gemini-Omni-1.1-Flash-API — Python SDK and MCP server for Google's newly announced Gemini Omni 1.1 Flash update.
- Awesome-Gemini-Omni-API-Prompts — Curated Gemini Omni prompts and REST examples.
- Open-Generative-AI — Browser-based GUI for the same models — no CLI required
- Awesome-GPT-Image-2-API-Prompts — Curated prompt library to run via this CLI
- ai-creator-academy — free curriculum teaching creators how to monetize generative AI, including running models via this CLI
- Flux-3-Dev-API — Python wrapper for Black Forest Labs' FLUX 3 (Dev variant) — text-to-image, image-to-image, text-to-video, image-to-video
- Grok-Imagine-Image-2-API — Python SDK and MCP server for Grok Imagine Image 2.0 generation and editing through MuAPI
- awesome-flux-3-api-prompts — FLUX 3 API guide, prompts, and parameters
- flux-3-video-api — Python wrapper focused on FLUX 3 Text-to-Video and Image-to-Video
- seedance-2.5-mcp — MCP server for generating Seedance 2.5 Preview videos through MuAPI.
- seedance-2-mcp — MCP server for generating Seedance 2 videos through MuAPI.
- Text-to-Speech-API — speech model comparison and raw API examples that can be run through the CLI.
- Speech-to-Text-API — transcription and audio-analysis examples for the same Muapi endpoints.
- Image-Enhancement-API — image upscaling and background-removal API examples.
- Video-Utilities-API — video enhancement and MMAudio utility examples.
- AI-3D-Model-API — Tripo3D and Meshy API comparisons and examples.
- muapi-skills — Agent skills (
npx skills add SamurAIGPT/muapi-skills) that let Claude Code, Cursor and Codex discover, price and run Muapi models through this CLI.
Install
# npm (recommended — no Python required)
npm install -g muapi-cli
# pip
pip install muapi-cli
# or run without installing
npx muapi-cli --help
Quick Start
# New user? Create an account
muapi auth register --email you@example.com --password "..."
muapi auth verify --email you@example.com --otp 123456
muapi auth login --email you@example.com --password "..."
# Or paste an existing API key
muapi auth configure --api-key "YOUR_KEY"
# Generate — pick a curated verb…
muapi image generate "a cyberpunk city at night" --model flux-dev
muapi video generate "a dog running on a beach" --model kling-master
muapi audio create "upbeat lo-fi hip hop for studying"
# …or run any model by endpoint name (schema-driven, covers the whole catalog)
muapi run flux-dev-image -p "a cyberpunk city at night"
muapi run seedance-2-text-to-video -p "drone shot over snowy peaks" -i duration=5
muapi run <model> -h # introspects the live OpenAPI schema
# Check balance
muapi account balance
# Wait for an existing job
muapi predict wait <request_id>
Commands
muapi auth
| Command | Description |
|---|---|
muapi auth register --email x --password y |
Create a new account (sends OTP) |
muapi auth verify --email x --otp 123456 |
Verify email after registration |
muapi auth login --email x --password y |
Log in and save API key automatically |
muapi auth forgot-password --email x |
Send password reset OTP |
muapi auth reset-password --email x --otp y --password z |
Reset password |
muapi auth configure |
Manually save an API key |
muapi auth whoami |
Show current API key (masked) |
muapi auth logout |
Remove stored API key |
muapi account
| Command | Description |
|---|---|
muapi account balance |
Show current credit balance |
muapi account topup --amount 20 |
Add credits via Stripe checkout |
muapi keys
| Command | Description |
|---|---|
muapi keys list |
List all API keys on your account |
muapi keys create --name label |
Create a new API key (shown once) |
muapi keys delete <id> |
Delete an API key by ID |
muapi image
| Command | Description |
|---|---|
muapi image generate <prompt> |
Text-to-image generation |
muapi image edit <prompt> --image <url> |
Image-to-image editing |
muapi image models |
List available models |
Models: flux-dev, flux-schnell, flux-kontext-dev/pro/max, hidream-fast/dev/full, wan2.1, reve, gpt4o, midjourney, seedream, qwen
muapi video
| Command | Description |
|---|---|
muapi video generate <prompt> |
Text-to-video generation |
muapi video from-image <prompt> --image <url> |
Image-to-video animation |
muapi video models |
List available models |
Models: veo3, veo3-fast, kling-master, kling-std, kling-pro, wan2.1/2.2, seedance-pro/lite, hunyuan, runway, pixverse, vidu, minimax-std/pro
muapi audio
| Command | Description |
|---|---|
muapi audio create <prompt> |
Create music with Suno |
muapi audio remix <song-id> |
Remix an existing Suno song |
muapi audio extend <song-id> |
Extend a Suno song |
muapi audio from-text <prompt> |
Generate audio with MMAudio |
muapi audio from-video <video-url> |
Add AI audio to a video |
muapi enhance
| Command | Description |
|---|---|
muapi enhance upscale <url> |
AI image upscaling |
muapi enhance bg-remove <url> |
Remove background |
muapi enhance face-swap --source <url> --target <url> |
Face swap image/video |
muapi enhance skin <url> |
Skin enhancement |
muapi enhance colorize <url> |
Colorize B&W photo |
muapi enhance ghibli <url> |
Ghibli anime style |
muapi enhance anime <url> |
Anime style conversion |
muapi enhance extend <url> |
Outpaint/extend image |
muapi enhance product-shot <url> |
Professional product photo |
muapi enhance erase <url> --mask <url> |
Object removal |
muapi edit
| Command | Description |
|---|---|
muapi edit effects --video <url> --effect <name> |
AI video/image effects |
muapi edit lipsync --video <url> --audio <url> |
Lip sync to audio |
muapi edit dance --image <url> --video <url> |
Make person dance |
muapi edit dress --image <url> |
Change clothing |
muapi edit clipping <video-url> |
AI highlight extraction |
muapi run — generic, schema-driven runner
Reaches any model in the muapi.ai catalog by endpoint name, even ones not covered by the curated image / video / audio / enhance / edit verbs. The input schema is fetched from the live OpenAPI spec, so muapi run <model> -h always reflects the real, current parameters.
| Command | Description |
|---|---|
muapi run <model> -h |
Print model-specific inputs from the live OpenAPI schema |
muapi run <model> -p "..." |
Run with a prompt |
muapi run <model> -p "..." -i k=v -i k=v |
Pass arbitrary inputs (JSON-parsed when valid) |
muapi run <model> --input-file inputs.json |
Inputs from a JSON file |
muapi run <model> ... --dry-run |
Show the request body without sending |
<model> accepts either a real endpoint slug (flux-dev-image, nano-banana-2, seedance-2-text-to-video) or a short alias from the curated tables (flux-dev, seedream, kling-master).
Merge order for inputs (later wins): --input-file → -i k=v → -p prompt.
# Discover a model's real inputs
muapi run nano-banana-2 -h
# Run it
muapi run nano-banana-2 -p "a logo for a coffee shop" -i num_images=2 --download ./out
# Pipe-safe JSON
muapi run flux-dev-image -p "..." --output-json --jq '.outputs[0]'
muapi predict
| Command | Description |
|---|---|
muapi predict result <id> |
Fetch current status (no polling) |
muapi predict wait <id> |
Wait until complete |
muapi upload
| Command | Description |
|---|---|
muapi upload file <path> |
Upload a local file → get hosted URL |
muapi models
| Command | Description |
|---|---|
muapi models list |
List all models |
muapi models list --category video |
Filter by category |
muapi config
| Command | Description |
|---|---|
muapi config set <key> <value> |
Set a persistent default |
muapi config get <key> |
Read a config value |
muapi config list |
Show all config |
Useful keys: output (json/human), model.image, model.video, no_color (true/false)
muapi docs
| Command | Description |
|---|---|
muapi docs openapi |
Fetch the full OpenAPI spec |
muapi docs open |
Open Swagger UI in browser |
muapi mcp
| Command | Description |
|---|---|
muapi mcp serve |
Start MCP server (stdio) for AI agents |
Global Options
| Flag | Description |
|---|---|
--wait / --no-wait |
Poll until done (default: --wait) |
--output-json / -j |
Print raw JSON response |
--jq <expr> |
Filter JSON output (e.g. '.outputs[0]') |
--download <dir> / -d |
Auto-download outputs to directory |
--no-color |
Disable colored output |
Environment Variables
| Variable | Description |
|---|---|
MUAPI_API_KEY |
API key (overrides keychain/config) |
MUAPI_BASE_URL |
Override API base URL |
NO_COLOR |
Disable colored output |
Exit Codes
| Code | Meaning |
|---|---|
0 |
Success |
1 |
General error |
3 |
Authentication error |
4 |
Rate limited |
5 |
Not found |
6 |
Billing error |
7 |
Timeout |
8 |
Validation error |
MCP Server
muapi supports two MCP transport modes. Both expose the same 19 tools: image generate/edit, video generate/from-image, audio create/from-text, enhance (upscale/bg-remove/face-swap/ghibli), edit lipsync/clipping, predict result, upload file, keys list/create/delete, account balance/topup.
Option 1 — Hosted (Recommended, no CLI required)
The hosted MCP server at https://api.muapi.ai/mcp uses the standard Streamable HTTP transport. Any MCP client can connect with just your API key — no CLI install needed.
Claude Code:
claude mcp add --transport http muapi \
https://api.muapi.ai/mcp \
--header "Authorization: Bearer YOUR_MUAPI_KEY"
Cursor — add to mcp.json (Cmd+Shift+P → Open MCP settings):
{
"mcpServers": {
"muapi": {
"url": "https://api.muapi.ai/mcp",
"headers": { "Authorization": "Bearer YOUR_MUAPI_KEY" }
}
}
}
Windsurf — open Settings → MCP:
{
"mcpServers": {
"muapi": {
"serverUrl": "https://api.muapi.ai/mcp",
"headers": { "Authorization": "Bearer YOUR_MUAPI_KEY" }
}
}
}
Option 2 — stdio via CLI (Claude Desktop)
Run the CLI as a local stdio MCP server. Requires the CLI to be installed.
muapi mcp serve
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"muapi": {
"command": "muapi",
"args": ["mcp", "serve"],
"env": { "MUAPI_API_KEY": "your-key-here" }
}
}
}
Any stdio-compatible client — use the command + args pattern above, substituting your client's config format.
For more details on the self-hosted MCP server see muapi-mcp-server.
Grok Build Plugin
This repository also ships a Grok Build plugin that connects Grok to Muapi's hosted MCP
server. Install the muapi plugin from the Grok Build marketplace, then set
MUAPI_API_KEY in the environment used by Grok Build:
export MUAPI_API_KEY="YOUR_MUAPI_KEY"
The plugin provides live model discovery plus image, video, audio, enhancement, editing, and async-result tools. Generation and enhancement consume Muapi credits; account top-ups, key management, and external publishing remain approval-gated by the plugin instructions.
For a direct project-local setup without waiting for marketplace review, add the hosted MCP server to Grok Build with:
grok mcp add --transport http muapi \
https://api.muapi.ai/mcp \
--header "Authorization: Bearer ${MUAPI_API_KEY}"
Agentic Pipeline Examples
# Full onboarding without human intervention
muapi auth register --email agent@example.com --password "secret"
muapi auth verify --email agent@example.com --otp 123456
muapi auth login --email agent@example.com --password "secret"
muapi account balance --output-json
muapi account topup --amount 10 --output-json --no-open
# Submit async, capture request_id, poll when ready
REQUEST_ID=$(muapi video generate "a dog on a beach" \
--model kling-master --no-wait --output-json --jq '.request_id' | tr -d '"')
muapi predict wait "$REQUEST_ID" --download ./outputs
# Chain: upload → edit → download
URL=$(muapi upload file ./photo.jpg --output-json --jq '.url' | tr -d '"')
muapi image edit "make it look like a painting" --image "$URL" \
--model flux-kontext-pro --download ./outputs
# Rotate API keys programmatically
NEW_KEY=$(muapi keys create --name "ci-$(date +%Y%m%d)" --output-json --jq '.api_key' | tr -d '"')
OLD_ID=$(muapi keys list --output-json --jq '.[0].id')
muapi keys delete "$OLD_ID" --yes
# Discover available endpoints
muapi docs openapi --jq '.paths | keys[]'
Shell Completions
muapi --install-completion bash
muapi --install-completion zsh
muapi --install-completion fish
Вопросы о muapi-cli MCP
Как добавить muapi-cli MCP в Claude Code?
Выполните claude mcp add muapi-cli -- npx -y muapi-cli в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить muapi-cli MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Как установить muapi-cli?
Вы можете установить его через npm с помощью команды npm install -g muapi-cli или через pip с помощью pip install muapi-cli.
Можно ли использовать это с AI агентами?
Да, инструмент спроектирован с приоритетом на агентов: он поддерживает вывод в формате JSON, фильтрацию jq и режим MCP server.
Как проверить баланс аккаунта?
Вы можете проверить текущий баланс кредитов, выполнив команду muapi account balance.