mediamcp

Enseña a cualquier agente de IA a crear imágenes y videos

mediamcp es un servidor MCP que conecta a tu asistente de IA — Claude Code, Claude Desktop, Cursor, Windsurf, VS Code o cualquier otro cliente compatible con MCP — con modelos multimedia en la nube (Gemini Flash Image, GPT-5 Image, Seedream, Veo, Sora, …) a través de OpenRouter o cualquier API compatible con OpenAI.

English | Español

⭐ El banner de arriba fue generado por el propio mediamcp: una sola llamada a generate_image.

Los archivos generados siempre se guardan en disco (por defecto en ~/Pictures/mediamcp), y cada respuesta contiene la ruta absoluta al archivo y una pequeña vista previa integrada: el agente ve inmediatamente lo que ha conseguido.

Para agentes de IA: las instrucciones de instalación, optimizadas especialmente para ti, están en llms-install.md.

Necesitarás una clave de API de OpenRouter: puedes obtenerla en https://openrouter.ai/keys.

Instalación rápida

Claude Code

claude mcp add mediamcp -e OPENROUTER_API_KEY=sk-or-v1-YOUR_KEY -- npx -y mediamcp

Claude Desktop

Añade en claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json) y reinicia Claude Desktop:

{
  "mcpServers": {
    "mediamcp": {
      "command": "npx",
      "args": ["-y", "mediamcp"],
      "env": { "OPENROUTER_API_KEY": "sk-or-v1-YOUR_KEY" }
    }
  }
}

Cursor

O añádelo en ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mediamcp": {
      "command": "npx",
      "args": ["-y", "mediamcp"],
      "env": { "OPENROUTER_API_KEY": "sk-or-v1-YOUR_KEY" }
    }
  }
}

Windsurf

Añádelo en ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mediamcp": {
      "command": "npx",
      "args": ["-y", "mediamcp"],
      "env": { "OPENROUTER_API_KEY": "sk-or-v1-YOUR_KEY" }
    }
  }
}

VS Code (GitHub Copilot)

O añádelo en .vscode/mcp.json (la clave se solicita por separado y no queda en el archivo):

{
  "servers": {
    "mediamcp": {
      "command": "npx",
      "args": ["-y", "mediamcp"],
      "env": { "OPENROUTER_API_KEY": "${input:openrouter-key}" }
    }
  },
  "inputs": [
    {
      "id": "openrouter-key",
      "type": "promptString",
      "password": true,
      "description": "OpenRouter API key (https://openrouter.ai/keys)"
    }
  ]
}

Related MCP server: mcp-media-engine

Qué podrá hacer tu agente

Después de la instalación, basta con decirle al agente algo como «genera una imagen hero para mi landing, 16:9», «quita el fondo de logo.png», «haz un video de 8 segundos con olas del océano al atardecer» o «anima logo.png a un video de 4 segundos» (image-to-video). El agente elegirá la herramienta adecuada:

Configuración

Todo se configura mediante variables de entorno en el bloque env de la configuración de tu cliente MCP:

Usar otro proveedor

Indica en MEDIAMCP_BASE_URL cualquier endpoint compatible con OpenAI y establece la clave correspondiente:

"env": {
  "MEDIAMCP_BASE_URL": "https://your-endpoint.example.com/v1",
  "MEDIAMCP_API_KEY": "your-key",
  "MEDIAMCP_MODEL": "your/image-model"
}

mediamcp determina por sí mismo qué formato de API soporta el endpoint: endpoint dedicado /images (OpenRouter), /images/generations (OpenAI clásico) o chat/completions con soporte de imágenes: la primera opción que funcione se recuerda.

Solución de problemas

1. Pídele al agente que ejecute la herramienta check_config: te dirá qué está mal configurado y cómo corregirlo.

2. La misma comprobación se puede ejecutar desde la terminal: npx -y mediamcp --check (se usan las variables de entorno de tu shell).

3. Problemas habituales:

   • «No API key configured» — añade OPENROUTER_API_KEY al bloque env de la entrada del servidor en la configuración del cliente MCP (no solo al perfil de tu shell) y reinicia el cliente.

   • «Out of credits (HTTP 402)» — recarga tu saldo en https://openrouter.ai/credits.

   • «Not found (HTTP 404) … for model» — slug de modelo incorrecto; ejecuta list_models.

   • En el cliente no ocurre nada — asegúrate de que Node.js ≥ 20 esté instalado (node --version).

   • «Tool '…' has an invalid outputSchema … unsupported dialect» — el cliente solo valida esquemas según JSON Schema 2020-12. mediamcp publica 2020-12 por defecto, así que el error significa una versión antigua: actualízate y asegúrate de que check_config muestre tool schema dialect: 2020-12.

Desarrollo

git clone https://github.com/legolev/mediamcp && cd mediamcp
npm install
npm run build       # сборка в dist/index.js
npm test            # юнит-тесты (vitest)
npm run inspect     # открыть MCP Inspector с собранным сервером

Licencia

MIT

mcp-name: io.github.legolev/mediamcp