Atlas Cloud Mcp Server (image / Video / Llm Apis)

by AtlasCloudAI

4 stars
328 downloads
Not rated
GitHub Website

About

A powerful MCP server for AI image, video, and LLM APIs. Integrate models like Seedance and Nano Banana into your workflow with a simple, unified interface powered by Atlas Cloud.

Details

Author
AtlasCloudAI
GitHub stars
4
Downloads
328
Categories
Cloud Service, Other, AI, Infrastructure, Media

- 300+ models: video, image, 3D, LLM, and audio TTS.
- Dynamic per‑model parameter schemas validated before every request.
- One‑step quick‑generate that auto‑finds the right model by keyword.
- Media upload for local images (temporary, for generation tasks only).
- Account balance, usage, and cost breakdown tools.
- Searchable documentation and model catalog.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Atlas Cloud Mcp Server (image / Video / Llm Apis)
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install by running a one‑line npx command or by adding a JSON configuration to your MCP‑compatible client. You must have Node.js ≥18 and an Atlas Cloud API key, set as the ATLASCLOUD_API_KEY environment variable. For CLI agents such as Claude Code or Gemini CLI, use claude mcp add atlascloud -- npx -y atlascloud-mcp. For IDEs like Cursor or VS Code, add a JSON block to your MCP settings with npx -y atlascloud-mcp as the command and your API key in the env section.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "atlas cloud mcp server (image / video / llm apis)": {
            "atlascloud": {
                "command": "node",
                "args": [
                    "index.js"
                ],
                "env": {
                    "ATLAS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

McpServers

{
    "atlascloud": {
        "command": "node",
        "args": [
            "index.js"
        ],
        "env": {
            "ATLAS_API_KEY": "<YOUR_API_KEY>"
        }
    }
}

<p align="center">
Atlas Cloud
</p>

<h1 align="center">Atlas Cloud MCP Server</h1>

<p align="center">
<a href="https://www.npmjs.com/package/atlascloud-mcp">npm version</a>
<a href="https://www.npmjs.com/package/atlascloud-mcp">npm downloads</a>
<a href="https://github.com/AtlasCloudAI/mcp-server">license</a>
<a href="https://github.com/AtlasCloudAI/mcp-server">github stars</a>
<a href="https://github.com/AtlasCloudAI/mcp-server/pulls">PRs Welcome</a>
</p>

<p align="center">
English | <a href="./docs/README.zh-CN.md">中文</a> | <a href="./docs/README.ja.md">日本語</a> | <a href="./docs/README.ko.md">한국어</a> | <a href="./docs/README.es.md">Español</a> | <a href="./docs/README.fr.md">Français</a>
</p>

<p align="center">
Use <a href="https://www.atlascloud.ai?utm_source=github&utm_campaign=mcp-server">Atlas Cloud</a>'s 300+ image / video / LLM models in Claude Code, Codex, Gemini CLI, Cursor, Cline and more. Generate images, videos & chat via standard MCP tools.
</p>

<p align="center">
<a href="https://www.atlascloud.ai/console/api-keys?utm_source=github&utm_campaign=mcp-server"><b>→ Get your free Atlas Cloud API key</b></a> · 300+ models · OpenAI-compatible
</p>

---

Supported Models

- 🎬 Video — Seedance 2.0 · Kling 3 · Sora 2 · Veo 3.1 · HappyHorse 1 · Grok Imagine 1.5 · Wan 2.7
- 🎨 Image — Nano Banana 2/Pro · GPT Image 2 · Flux 2 · Seedream 5
- 🧊 3D — Hunyuan 3D image-to-3D / text-to-3D
- 💬 LLM — Claude · GPT · DeepSeek · MiniMax · Kimi · GLM · Qwen
- 🔊 Audio (TTS) — Seed Audio · xAI/Grok TTS · ElevenLabs

- 📚 Explore more300+ models »

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 Kling 3, Seedance 2, Veo 3.1, Sora 2…
- 🧊 "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
- 🎞️ "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_KEY environment 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) with any supported audio model |
| 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:
1. Use atlas_list_models to find Seedream image models
2. Use atlas_get_model_info to get the model's parameters
3. Use atlas_generate_image with the correct parameters

Generate a video

> "Create a video of a rocket launch using Kling v3"

The assistant will:
1. Find the Kling video model
2. Get its schema to understand required parameters
3. Use atlas_generate_video with 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:
1. Use atlas_upload_media to upload the local file and get a URL
2. Find an image-editing model
3. Use atlas_generate_image with 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:
1. Use atlas_list_models with type="Audio" to find the TTS model
2. Use atlas_generate_audio with the text to synthesize
3. Use atlas_get_prediction to retrieve the generated audio 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 nodesatlascloud_comfyui
- 🔁 n8n nodesn8n-nodes-atlascloud
- 💬 Join our Discorddiscord.gg/MWmMr4q9es
- 🌐 Websiteatlascloud.ai

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.