README.es.md
July 2, 2026 · View on GitHub
Atlas Cloud MCP Server
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 — Seedance 2.0 · Kling 3 · Sora 2 · Veo 3.1 · HappyHorse 1 · Grok Imagine 1.5 · Wan 2.7
-
🎨 Imagen — Nano Banana 2/Pro · GPT Image 2 · Flux 2 · Seedream 5
-
🧊 3D — Hunyuan 3D imagen-a-3D / texto-a-3D
-
💬 LLM — Claude · GPT · DeepSeek · MiniMax · Kimi · GLM · Qwen
-
🔊 Audio (TTS) — Seed Audio · xAI/Grok TTS · ElevenLabs
-
📚 Explora más — más de 300 modelos »
Contenido
- Qué puedes hacer
- Inicio rápido
- Herramientas disponibles
- Ejemplos de uso
- Desarrollo
- Más herramientas de Atlas Cloud
- Licencia
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 Kling 3, Seedance 2, Veo 3.1, Sora 2…
- 🧊 "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), 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
- Node.js >= 18
- API Key de Atlas Cloud — Consíguela gratis en atlascloud.ai
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_KEYen 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 | Listar todos los modelos disponibles, con filtro opcional por tipo (Text/Image/Video/Audio) |
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) con cualquier modelo de audio compatible |
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 | Subir archivos locales para obtener una URL utilizable con modelos de edición de imagen / imagen-a-vídeo |
atlas_chat | Chatear con modelos LLM (formato compatible con OpenAI) |
atlas_get_prediction | Consultar el estado y el resultado de las tareas de generación de imagen/vídeo/audio/3D |
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:
- Usar
atlas_list_modelspara encontrar los modelos de imagen Seedream - Usar
atlas_get_model_infopara obtener los parámetros del modelo - Usar
atlas_generate_imagecon 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:
- Encontrar el modelo de vídeo Kling
- Obtener su esquema para comprender los parámetros requeridos
- Usar
atlas_generate_videocon 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:
- Usar
atlas_upload_mediapara subir el archivo local y obtener una URL - Encontrar un modelo de edición de imagen
- Usar
atlas_generate_imagecon 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:
- Usar
atlas_list_modelscontype="Audio"para encontrar el modelo TTS - Usar
atlas_generate_audiocon el texto que se va a sintetizar - Usar
atlas_get_predictionpara 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
- 🧰 ¿Quieres usarlo desde la terminal? → atlascloud-cli
- 🤖 ¿Quieres usarlo en Claude Code / Cursor? → Atlas Cloud MCP Server
- 🎬 ¿Lo quieres como Skill de Claude Code / Codex / Gemini CLI? → atlas-cloud-skills
- 🎨 Nodos de ComfyUI → atlascloud_comfyui
- 🔁 Nodos de n8n → n8n-nodes-atlascloud
- 💬 Únete a nuestro Discord → discord.gg/MWmMr4q9es
- 🌐 Sitio web → atlascloud.ai
Licencia
MIT