Skip to content

README.es.md

Latest commit

 

History

History
243 lines (173 loc) · 12.4 KB

README.es.md

File metadata and controls

243 lines (173 loc) · 12.4 KB
Raw

Atlas Cloud

Atlas Cloud MCP Server

npm version npm downloads license github stars PRs Welcome

English | 中文 | 日本語 | 한국어 | Español | Français

Usa los más de 300 modelos de imagen / vídeo / LLM de Atlas Cloud en Claude Code, Codex, Gemini CLI, Cursor, Cline y muchos más. Genera imágenes, vídeos y chatea mediante herramientas MCP estándar.

→ Consigue tu API key gratuita de Atlas Cloud · más de 300 modelos · compatible con OpenAI

Modelos compatibles

  • 🎬 Vídeo (192) — MiniMax H3 Max · Gemini Omni 1.1 Flash · MiniMax H3 · Wan-3.0-Prime · Wan-3.0 · Seedance 2.5

  • 🎨 Imagen (116) — Seedream v4.7 · MAI-Image-2.5-Pro · MAI-Image-2.5-Flash · Grok Imagine Image 2.0

  • 🧊 3D (7) — Seed3D 2.0 · Tripo H3.1 · Hunyuan 3D Rapid · Hunyuan 3D Pro

  • 💬 LLM (69) — DeepSeek V4 Pro 0813 · Grok 4.6 · DeepSeek V4 Flash Vision Exp · DeepSeek V4 Flash 0731

  • 🔊 Audio (TTS · Música · ASR) (17) — Suno chirp-v4-5-all · Suno chirp-v4-5-plus · Suno chirp-auk · Suno chirp-fenix

  • 📚 Explora más — los 419 modelos en vivo »

🎬 Modelos de vídeo más recientes — Seedance 2.5 · Kling 4.0 · Wan 3.0 · Kling Video O3.

Contenido

Qué puedes hacer

Pídeselo a tu asistente de IA en lenguaje natural: él descubre el modelo adecuado, construye los parámetros y envía la tarea:

  • 🎨 "Crea una imagen destacada para esta entrada de blog" — texto-a-imagen con Nano Banana Pro, GPT Image 2, Flux 2, Seedream, Imagen…
  • 🎬 "Convierte esta foto de producto en un anuncio de 5 segundos" — imagen-a-vídeo con Seedance 2.5, Kling 3, Kling Video O3, Veo 3.1…
  • 🧊 "Crea un modelo 3D a partir de esta foto" — imagen-a-3D / texto-a-3D con Hunyuan 3D (salida GLB/OBJ/USDZ)
  • 🔊 "Lee este guion en voz alta" — texto-a-voz con Seed Audio, ElevenLabs, xAI TTS
  • 🎞️ "Convierte este guion en un storyboard de 6 planos" — encadena LLM → imagen → vídeo dentro de una sola conversación
  • ✏️ "Edita esta imagen — añade un sombrero" — sube un archivo local y luego ejecuta un modelo de edición de imagen
  • 💸 "¿Cuánto crédito me queda y cuánto he gastado este mes?" — consulta el saldo, el uso y el desglose de costes
  • 💬 "Resume este PDF con DeepSeek" — chat LLM compatible con OpenAI con Claude, GPT, DeepSeek, Qwen, GLM…

Por debajo: descubrimiento de modelos, esquemas de parámetros dinámicos por modelo (validados antes de cada solicitud, de modo que los parámetros inválidos fallan de inmediato sin gastar créditos, además de un indicador dry_run en cada herramienta de generación que muestra el cuerpo exacto de la solicitud sin enviarla), carga de medios, generación rápida en un paso, saldo y uso de la cuenta, y búsqueda en la documentación, todo expuesto como herramientas MCP estándar (consulta Herramientas disponibles).

Inicio rápido

Requisitos previos

Consulta .env.example para conocer la variable de entorno que debes configurar.

Agentes CLI (instalación en una línea)

La vía más rápida: estos agentes de programación con IA añaden el servidor con un solo comando:

# Claude Code
claude mcp add atlascloud -- npx -y atlascloud-mcp

# OpenAI Codex CLI
codex mcp add atlascloud -- npx -y atlascloud-mcp

# Gemini CLI
gemini mcp add atlascloud -- npx -y atlascloud-mcp

# Goose CLI
goose mcp add atlascloud -- npx -y atlascloud-mcp

Configura primero la variable de entorno ATLASCLOUD_API_KEY en tu shell.

IDEs, editores y extensiones (configuración JSON)

Añade lo siguiente a la configuración MCP de tu cliente — funciona con todos los clientes compatibles con MCP:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}
Cliente Dónde añadirlo
Cursor Settings → MCP → Add Server
Cline MCP Marketplace → Add Server
Continue config.yaml → MCP
Windsurf Settings → MCP → Add Server
VS Code (Copilot) .vscode/mcp.json o Settings → MCP
Trae Settings → MCP → Add Server
JetBrains IDEs Settings → Tools → AI Assistant → MCP
ChatGPT Desktop Settings → MCP
Amazon Q Developer MCP Configuration
Roo Code Settings → MCP → Add Server

¿Prefieres Skills?

Si prefieres usar Skills en lugar de MCP, también ofrecemos un paquete Atlas Cloud Skills para Claude Code y otros agentes compatibles con Skills.

Herramientas disponibles

Herramienta Descripción
atlas_search_docs Buscar en la documentación y los modelos de Atlas Cloud por palabra clave
atlas_list_models Lista los modelos disponibles, filtrando por tipo (Text/Image/Video/Audio), subtipo (3d/tts/stt/music/lyrics) o palabra clave
atlas_get_model_info Obtener información detallada del modelo, incluyendo esquema de la API, parámetros y ejemplos de uso
atlas_generate_image Generar imágenes y modelos 3D (imagen-a-3D / texto-a-3D) con cualquier modelo de imagen compatible
atlas_generate_video Generar vídeos con cualquier modelo de vídeo compatible
atlas_generate_audio Generar audio — voz (TTS) y música/canciones (Suno, MiniMax Music)
atlas_transcribe_audio Transcribir voz a texto (ASR) — reuniones, entrevistas, notas de voz
atlas_quick_generate Generación de imagen/vídeo/audio en un paso — encuentra el modelo por palabra clave, construye los parámetros y envía
atlas_upload_media Sube una imagen, audio, vídeo o documento local y obtén una URL para pasarla a cualquier modelo
atlas_chat Chatea con modelos LLM — el endpoint y el formato de petición se eligen automáticamente según el modelo (OpenAI chat/responses, Anthropic messages, Gemini nativo); admite entrada de imagen/vídeo/audio
atlas_get_prediction Consulta el estado y el resultado de una tarea de generación — URLs de medios, transcripciones, letras, portada y coste
atlas_list_predictions Consulta tareas de generación anteriores — recupera un prediction ID perdido o revisa resultados previos
atlas_get_balance Obtener el saldo de la cuenta y el resumen de créditos de tu API key
atlas_get_model_usage Obtener el uso diario por modelo (solicitudes, tokens, recuentos de imagen/vídeo) en un rango de fechas
atlas_get_model_costs Obtener los tramos de coste (gasto) diario por modelo en un rango de fechas

Ejemplos de uso

Buscar modelos

"Busca en Atlas Cloud modelos de generación de vídeo"

Tu asistente de IA usará atlas_search_docs o atlas_list_models para encontrar los modelos relevantes.

Generar una imagen

"Genera una imagen de un gato en el espacio usando Seedream"

El asistente hará lo siguiente:

  1. Usar atlas_list_models para encontrar los modelos de imagen Seedream
  2. Usar atlas_get_model_info para obtener los parámetros del modelo
  3. Usar atlas_generate_image con los parámetros correctos

Generar un vídeo

"Crea un vídeo del lanzamiento de un cohete usando Kling v3"

El asistente hará lo siguiente:

  1. Encontrar el modelo de vídeo Kling
  2. Obtener su esquema para comprender los parámetros requeridos
  3. Usar atlas_generate_video con los parámetros adecuados

Subir una imagen local para editar o generar vídeo

"Edita esta imagen /Users/me/photos/cat.jpg para añadir un sombrero"

El asistente hará lo siguiente:

  1. Usar atlas_upload_media para subir el archivo local y obtener una URL
  2. Encontrar un modelo de edición de imagen
  3. Usar atlas_generate_image con la URL subida

Nota: Los archivos subidos son solo para uso temporal con las tareas de generación de Atlas Cloud. Los archivos pueden eliminarse periódicamente. No lo utilices como alojamiento permanente de archivos — el abuso puede provocar la suspensión de la API key.

Generar voz (TTS)

"Lee esta frase en voz alta con Seed Audio: Welcome to Atlas Cloud"

El asistente hará lo siguiente:

  1. Usar atlas_list_models con type="Audio" para encontrar el modelo TTS
  2. Usar atlas_generate_audio con el texto que se va a sintetizar
  3. Usar atlas_get_prediction para recuperar la URL del audio generado

Generar un modelo 3D

"Convierte esta foto de producto en un modelo 3D con Hunyuan 3D"

Los modelos 3D son modelos de tipo Image, por lo que el asistente usa atlas_generate_image con el parámetro image y recupera un archivo GLB/OBJ/USDZ mediante atlas_get_prediction.

Chatear con un LLM

"Pídele a Qwen que explique la computación cuántica"

El asistente usará atlas_chat con el modelo Qwen.

Consultar saldo y uso

"¿Cuánto crédito de Atlas Cloud me queda y cuánto he gastado este mes?"

El asistente usará atlas_get_balance para el saldo actual y atlas_get_model_costs para el desglose del gasto.

Desarrollo

# Instalar dependencias
npm install

# Compilar
npm run build

# Ejecutar en modo desarrollo
npm run dev

Más herramientas de Atlas Cloud

Licencia

MIT