MCP工具

Quick Start

```bash

Agentic Pipeline Examples

```bash

`muapi config`

Useful keys: output (json/human), model.image, model.video, no_color (true/false)

Global Options

Environment Variables

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.

muapi 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).

Or paste an existing API key

muapi auth configure --api-key "YOUR_KEY"

…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

`muapi auth`

`muapi account`

`muapi keys`

`muapi image`

Models: flux-dev, flux-schnell, flux-kontext-dev/pro/max, hidream-fast/dev/full, wan2.1, reve, gpt4o, midjourney, seedream, qwen

`muapi video`

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`

`muapi enhance`

`muapi edit`

`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.

<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.

```bash

`muapi predict`

`muapi upload`

`muapi models`

`muapi docs`

`muapi mcp`

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[]' ```