AtlasCloudAI/mcp-server
MCP server for Atlas Cloud - AI API aggregation platform for image/video generation and LLM
安装Install
dsh plugin --profile web add github:AtlasCloudAI/mcp-server把 AtlasCloudAI/mcp-server 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
Atlas Cloud MCP Server
English | 中文 | 日本語 | 한국어 | Español | Français
Use Atlas Cloud's 300+ image / video / LLM models in Claude Code, Codex, Gemini CLI, Cursor, Cline and more. Generate images, videos & chat via standard MCP tools.
→ Get your free Atlas Cloud API key · 300+ models · OpenAI-compatible
Supported Models
🎬 Video (177) — Seedance 2.5 · MiniMax H3 · Youchuan V8.2 · Seedance 2.0 Mini · HappyHorse-1.1 · Gemini Omni Flash
🎨 Image (118) — Grok Imagine Image 2.0 · Qwen Image 3.0 Pro · Seedream v5.0 Pro · Qwen Image 3.0
🧊 3D (7) — Seed3D 2.0 · Hunyuan 3D Rapid · Hunyuan 3D Pro · Tripo H3.1
💬 LLM (65) — Grok 4.6 · DeepSeek V4 Pro 0813 · DeepSeek V4 Flash 0731 · Qwen3.8 Max
🔊 Audio (TTS · Music · ASR) (17) — Suno chirp-v4-5-all · Suno chirp-v4-5-plus · Suno chirp-auk · Suno chirp-fenix
📚 Explore more — all 395 live models »
🎬 Newest video models — Seedance 2.5 · Kling 4.0 · Wan 3.0 · Kling Video O3.
Contents
- What You Can Do
- Quick Start
- Available Tools
- Usage Examples
- Development
- More Atlas Cloud Tools
- License
What You Can Do
Ask your AI assistant in plain language — it discovers the right model, builds the parameters, and submits the job:
- 🎨 "Make a hero image for this blog post" — text-to-image across Nano Banana Pro, GPT Image 2, Flux 2, Seedream, Imagen…
- 🎬 "Turn this product photo into a 5-second ad" — image-to-video with Seedance 2.5, Kling 3, Kling Video O3, Veo 3.1…
- 🧊 "Make a 3D model from this photo" — image-to-3D / text-to-3D with Hunyuan 3D (GLB/OBJ/USDZ output)
- 🔊 "Read this script aloud" — text-to-speech with Seed Audio, ElevenLabs, xAI TTS
- 🎵 "Write a theme song for my app" — music generation with Suno, MiniMax Music
- 📝 "Transcribe this meeting recording" — speech-to-text with Seed ASR, xAI STT
- 🎞️ "Storyboard this script into 6 shots" — chain LLM → image → video inside one conversation
- ✏️ "Edit this image — add a hat" — upload a local file, then run an image-editing model
- 💸 "How much credit is left, and what did I spend this month?" — check balance, usage, and cost breakdowns
- 💬 "Summarize this PDF with DeepSeek" — OpenAI-compatible LLM chat with Claude, GPT, DeepSeek, Qwen, GLM…
Under the hood: model discovery, dynamic per-model parameter schemas (validated before every request so invalid params fail fast without spending credits), media upload, one-step quick-generate, account balance & usage, and documentation search — all exposed as standard MCP tools (see Available Tools).
Quick Start
Prerequisites
- Node.js >= 18
- Atlas Cloud API Key — Get one free at atlascloud.ai
See .env.example for the environment variable to set.
CLI agents (one-line install)
The fastest path — these AI coding agents add the server with a single command:
# 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
Set the
ATLASCLOUD_API_KEYenvironment variable in your shell first.
IDEs, editors & extensions (JSON config)
Add this to your client's MCP configuration — works with every MCP-compatible client:
{
"mcpServers": {
"atlascloud": {
"command": "npx",
"args": ["-y", "atlascloud-mcp"],
"env": {
"ATLASCLOUD_API_KEY": "your-api-key-here"
}
}
}
}
| Client | Where to add it |
|---|---|
| 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 or 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 |
Prefer Skills?
If you'd rather use Skills than MCP, we also ship an Atlas Cloud Skills package for Claude Code and other skill-compatible agents.
Available Tools
| Tool | Description |
|---|---|
atlas_search_docs |
Search Atlas Cloud documentation and models by keyword |
atlas_list_models |
List all available models, optionally filtered by type (Text/Image/Video/Audio) |
atlas_get_model_info |
Get detailed model info including API schema, parameters, and usage examples |
atlas_generate_image |
Generate images and 3D models (image-to-3D / text-to-3D) with any supported Image model |
atlas_generate_video |
Generate videos with any supported video model |
atlas_generate_audio |
Generate audio — speech (TTS) and music/songs (Suno, MiniMax Music) — with any supported audio model |
atlas_transcribe_audio |
Transcribe speech to text (ASR) — meetings, interviews, voice notes |
atlas_quick_generate |
One-step image/video/audio generation — auto-finds model by keyword, builds params, and submits |
atlas_upload_media |
Upload local files to get a URL for use with image-edit / image-to-video models |
atlas_chat |
Chat with LLM models (OpenAI-compatible format) |
atlas_get_prediction |
Check status and result of image/video/audio/3D generation tasks |
atlas_get_balance |
Get the account balance and credit summary for your API key |
atlas_get_model_usage |
Get daily model usage (requests, tokens, image/video counts) over a date range |
atlas_get_model_costs |
Get daily model cost (spend) buckets over a date range |
Usage Examples
Search for models
"Search Atlas Cloud for video generation models"
Your AI assistant will use atlas_search_docs or atlas_list_models to find relevant models.
Generate an image
"Generate an image of a cat in space using Seedream"
The assistant will:
- Use
atlas_list_modelsto find Seedream image models - Use
atlas_get_model_infoto get the model's parameters - Use
atlas_generate_imagewith the correct parameters
Generate a video
"Create a video of a rocket launch using Kling v3"
The assistant will:
- Find the Kling video model
- Get its schema to understand required parameters
- Use
atlas_generate_videowith appropriate parameters
Upload a local image for editing or video generation
"Edit this image /Users/me/photos/cat.jpg to add a hat"
The assistant will:
- Use
atlas_upload_mediato upload the local file and get a URL - Find an image-editing model
- Use
atlas_generate_imagewith the uploaded URL
Note: Uploaded files are for temporary use with Atlas Cloud generation tasks only. Files may be cleaned up periodically. Do not use this as permanent file hosting — abuse may result in API key suspension.
Generate speech (TTS)
"Read this sentence aloud with Seed Audio: Welcome to Atlas Cloud"
The assistant will:
- Use
atlas_list_modelswithtype="Audio"to find the TTS model - Use
atlas_generate_audiowith the text to synthesize - Use
atlas_get_predictionto retrieve the generated audio URL
Generate music
"Make a 30-second upbeat synthwave track for my product demo with Suno"
Music models (Suno Chirp, MiniMax Music) are Audio-type models, so the assistant uses atlas_generate_audio with a song description (and optionally lyrics), then retrieves the audio URL via atlas_get_prediction.
Transcribe audio (speech-to-text)
"Transcribe this interview recording: https://example.com/interview.mp3"
The assistant uses atlas_transcribe_audio with a speech-to-text model (e.g., bytedance/seed-asr-2.0) and the audio_url, then retrieves the transcript via atlas_get_prediction. For local files, it first calls atlas_upload_media to get a URL.
Generate a 3D model
"Turn this product photo into a 3D model with Hunyuan 3D"
3D models are Image-type models, so the assistant uses atlas_generate_image with the image parameter and retrieves a GLB/OBJ/USDZ file via atlas_get_prediction.
Chat with an LLM
"Ask Qwen to explain quantum computing"
The assistant will use atlas_chat with the Qwen model.
Check balance and usage
"How much Atlas Cloud credit do I have left, and what did I spend this month?"
The assistant will use atlas_get_balance for the current balance and atlas_get_model_costs for the spend breakdown.
Development
# Install dependencies
npm install
# Build
npm run build
# Run in development mode
npm run dev
More Atlas Cloud Tools
- 🧰 Want to use it from the terminal? → atlascloud-cli
- 🤖 Want to use it in Claude Code / Cursor? → Atlas Cloud MCP Server
- 🎬 Want it as a Claude Code / Codex / Gemini CLI Skill? → atlas-cloud-skills
- 🎨 ComfyUI nodes → atlascloud_comfyui
- 🔁 n8n nodes → n8n-nodes-atlascloud
- 💬 Join our Discord → discord.gg/MWmMr4q9es
- 🌐 Website → atlascloud.ai
License
MIT
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …