Runware MCP

Runware MCP

Servidor MCP que dá acesso a agentes de IA (Claude, Cursor, Codex, etc.) à API completa do Runware — geração de imagens, geração de vídeos, geração de áudio, 3D, upscaling, remoção de fundo, legendagem e muito mais.

Instalação

Escolha um — npx é o mais simples, a instalação global é mais rápida em uso repetido.

# Use directly with npx (no install)
npx -y @runware/mcp

# Or install globally
npm install -g @runware/mcp

Conexão

Obtenha uma chave de API em runware.ai. Em seguida, aponte seu agente para o MCP.

Claude Desktop

Adicione a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "runware": {
      "command": "npx",
      "args": ["-y", "@runware/mcp"],
      "env": {
        "RUNWARE_API_KEY": "your-api-key"
      }
    }
  }
}

Se você instalou globalmente:

{
  "mcpServers": {
    "runware": {
      "command": "runware-mcp",
      "env": {
        "RUNWARE_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Configurações → MCP → Adicionar servidor — mesma configuração acima.

Codex

Adicione à sua configuração MCP com o mesmo comando e env.

Como usar

Depois de conectado, basta conversar com seu agente. Ele escolhe a ferramenta certa, escolhe o modelo certo e preenche os parâmetros.

• "Gere uma imagem de um gato em uma floresta"
• "Quais modelos você tem para geração de vídeos?"
• "Faça upscale de https://example.com/photo.jpg em 4x"
• "Mostre-me meu saldo de conta"
• "Encontre-me um LoRA da Civitai para estilo anime"

O agente descobre qual modelo se encaixa, quais parâmetros passar e como interpretar a resposta. Os parâmetros são validados contra o schema de cada modelo antes do envio, então o agente recebe feedback rápido quando escolhe valores incorretos.

Ferramentas às quais o agente tem acesso

Você não as chama diretamente — o agente as chama, com base no que você solicita.

• run — executa qualquer tarefa de inferência do Runware (imagem, vídeo, áudio, 3D, upscaling, legendagem, etc.) em um determinado modelo
• model_schema — busca o schema de parâmetros de um modelo específico
• list_models — lista as integrações oficiais e curadas do Runware (suporta filtros capability, category, creator, search)
• model_details — obtém metadados completos de um modelo curado por AIR
• model_examples — obtém pares de exemplo de entrada/saída para um modelo curado
• model_pricing — obtém visão geral de preços + exemplos por configuração para um modelo curado
• list_capabilities — lista todas as capacidades do modelo (ex.: io:text-to-image, op:upscale) com rótulos
• model_search — pesquisa o catálogo de modelos da comunidade (fine-tunes do Civitai, uploads personalizados)
• media_storage — armazena mídia (imagens, vídeos, áudio, modelos 3D) para uso como entrada, ou exclui mídia armazenada
• model_upload — envia um modelo personalizado
• account — recupera informações da conta, incluindo saldo e uso
• get_task_details — recupera a solicitação e a resposta originais de uma tarefa anterior

Variáveis de ambiente

Variável	Obrigatória	Descrição
RUNWARE_API_KEY	Sim	Sua chave de API do Runware

Desenvolvimento

# Run directly (no build step)
npm run dev

# Build
npm run build

# Test
npm test

# Lint
npm run lint

# Smoke-test the stdio protocol
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | RUNWARE_API_KEY=your-key node dist/index.js

# Or use the MCP Inspector for a UI
npx @modelcontextprotocol/inspector node dist/index.js