Runware MCP

Runware MCP

Servidor MCP que da a los agentes de IA (Claude, Cursor, Codex, etc.) acceso a la API completa de Runware: generación de imágenes, generación de video, generación de audio, 3D, escalado, eliminación de fondo, subtitulado y más.

Instalación

Elige uno: npx es el más sencillo, la instalación global es más rápida en uso repetido.

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

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

Conexión

Obtén una clave de API en runware.ai. Luego apunta tu agente al MCP.

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Si instalaste globalmente:

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

Cursor

Configuración → MCP → Añadir servidor: la misma configuración que arriba.

Codex

Añade a tu configuración de MCP con el mismo comando y env.

Cómo usarlo

Una vez conectado, solo habla con tu agente. Él elige la herramienta correcta, el modelo correcto y rellena los parámetros.

• "Genera una imagen de un gato en un bosque"
• "¿Qué modelos tienes para generación de video?"
• "Escala https://example.com/photo.jpg por 4x"
• "Muéstrame el saldo de mi cuenta"
• "Encuéntrame un LoRA de Civitai para estilo anime"

El agente determina qué modelo se ajusta, qué parámetros pasar y cómo interpretar la respuesta. Los parámetros se validan contra el esquema de cada modelo antes de enviarlos, por lo que el agente recibe comentarios rápidos cuando elige valores incorrectos.

Herramientas a las que el agente tiene acceso

No las llamas directamente; el agente lo hace según lo que pidas.

• run — ejecuta cualquier tarea de inferencia de Runware (imagen, video, audio, 3D, escalado, subtitulado, etc.) en un modelo dado
• model_schema — obtiene el esquema de parámetros para un modelo específico
• list_models — lista las integraciones de modelos oficiales y curados de Runware (admite filtros capability, category, creator, search)
• model_details — obtiene metadatos completos para un modelo curado por AIR
• model_examples — obtiene pares de entrada/salida de ejemplo para un modelo curado
• model_pricing — obtiene una visión general de precios y ejemplos por configuración para un modelo curado
• list_capabilities — lista cada capacidad del modelo (p. ej., io:text-to-image, op:upscale) con etiquetas
• model_search — busca en el catálogo de modelos comunitarios (fine-tunes de Civitai, subidas personalizadas)
• media_storage — almacena medios (imágenes, video, audio, modelos 3D) para usarlos como entrada, o elimina medios almacenados
• model_upload — sube un modelo personalizado
• account — recupera información de la cuenta, incluido el saldo y el uso
• get_task_details — recupera la solicitud y respuesta originales de una tarea anterior

Variables de entorno

Variable	Requerida	Descripción
RUNWARE_API_KEY	Sí	Tu clave de API de Runware

Desarrollo

# 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