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

Atlas Cloud MCP 服务

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

在 Claude Code、Codex、Gemini CLI、Cursor、Cline 等工具中使用 Atlas Cloud 的 300 多种图像、视频和大模型。通过标准 MCP 工具生成图像、视频并进行聊天。

→ 获取免费的 Atlas Cloud API 密钥 · 300 多种模型 · 兼容 OpenAI

---

支持的模型

• 🎬 视频（230）— Seedance 2.5 · MiniMax H3 Max · MiniMax H3 Fast · Gemini Omni 1.1 Flash · MiniMax H3 · Wan-3.0-Prime

• 🎨 图像（138）— GPT Image 2.5 Sunburst · GPT Image 2.5 Flare · Seedream v4.7 · MAI-Image-2.6-Flash

• 🧊 3D（14）— Seed3D 2.0 · Tripo H3.1 · Hunyuan 3D Rapid · Hunyuan 3D Pro

• 💬 大模型（82）— DeepSeek V4.1 Flash 1017 · Kimi K3.1 Pro HighSpeed · Kimi K3.1 Pro · Gemini 4 Argon

• 🔊 音频（TTS · 音乐 · ASR）（15）— Seed Audio 1.0 · MiniMax Speech 2.6 Turbo · MiniMax Speech 2.6 HD · xAI TTS v1

• 📚 探索更多 — 全部 511 个在线模型 »

🎬 最新视频模型 — Seedance 2.5 · Kling 4.0 · Wan 3.0 · Kling Video O3。

目录

• 功能介绍
• 快速开始
• 可用工具
• 使用示例
• 开发
• 更多 Atlas Cloud 工具
• 许可证

你可以做什么

用自然语言向 AI 助手提出请求——它会发现合适的模型、构建参数并提交任务：

• 🎨 “为这篇博客文章制作一张头图” — 使用 Nano Banana Pro、GPT Image 2、Flux 2、Seedream、Imagen…进行文生图
• 🎬 “把这张产品照片变成 5 秒广告” — 使用 Seedance 2.5、Kling 3、Kling Video O3、Veo 3.1…进行图生视频
• 🧊 “根据这张照片制作一个 3D 模型” — 使用 Hunyuan 3D 进行图生 3D / 文生 3D（输出 GLB/OBJ/USDZ）
• 🔊 “朗读这段脚本” — 使用 Seed Audio、ElevenLabs、xAI TTS 进行文生语音
• 🎵 “为我的应用创作一首主题曲” — 使用 Suno、MiniMax Music 生成音乐
• 📝 “转录这段会议录音” — 使用 Seed ASR、xAI STT 进行语音转文字
• 🎞️ “把这段脚本拆成 6 个镜头的分镜” — 在一次对话中串联 LLM → 图像 → 视频
• ✏️ “编辑这张图像——加一顶帽子” — 上传本地文件，然后运行图像编辑模型
• 💸 “还剩多少额度？我这个月花了多少？” — 查看余额、使用情况和费用明细
• 💬 “这张截图里有什么？” — 使用 Claude、GPT、DeepSeek、Qwen、Gemini、GLM…进行 LLM 对话，并在支持的模型上输入图像/视频
• 🕓 “我昨天生成了什么？” — 浏览生成历史记录并取回输出 URL

在底层，模型发现、按模型动态生成的参数模式（每次请求前都会验证，因此无效参数会立即报错，不会消耗额度；此外，每个生成工具都提供 dry_run 标志，可在不提交请求的情况下显示确切的请求正文）、媒体上传、一步式快速生成、生成历史记录、账户余额与使用情况，以及文档搜索——全部作为标准 MCP 工具提供（请参阅可用工具）。

LLM 调用会遵循协议：每个模型都通过其实际声明的接口调用——OpenAI chat completions、OpenAI Responses、Anthropic Messages 或原生 Gemini generateContent——因此，Gemini 原生模型无需你进行任何特殊处理即可使用。

快速开始

托管服务——无需 API 密钥，无需安装

将客户端指向我们的托管 MCP 服务，然后在浏览器中登录一次。无需安装任何内容，无需创建或粘贴密钥，生成费用将计入你登录时使用的 Atlas Cloud 账户。

端点： https://mcp.atlascloud.ai/mcp

Claude Code

claude mcp add --transport http --scope user atlas-cloud https://mcp.atlascloud.ai/mcp

删除 --scope user 可仅将其添加到当前项目。添加服务并不会让你登录——之后请在 Claude Code 中运行 /mcp，并按照浏览器提示操作。

也可以直接将其添加到 .mcp.json：

{
  "mcpServers": {
    "atlas-cloud": {
      "type": "http",
      "url": "https://mcp.atlascloud.ai/mcp"
    }
  }
}

这里必须填写 type——否则 Claude Code 会将该条目识别为 stdio 服务并跳过。

ChatGPT 和 Codex

安装插件，该插件将此服务与我们的 skills 一同打包：

codex plugin marketplace add AtlasCloudAI/atlas-cloud-plugin
codex plugin add atlas-cloud@atlas-cloud
codex mcp login atlas-cloud

在 ChatGPT 桌面应用中：Settings → Plugins → Add → Add plugin marketplace，来源填写 AtlasCloudAI/atlas-cloud-plugin，然后打开 Atlas Cloud 并安装。

VS Code

在 .vscode/mcp.json 中：

{
  "servers": {
    "atlas-cloud": {
      "type": "http",
      "url": "https://mcp.atlascloud.ai/mcp"
    }
  }
}

其他 MCP 客户端

大多数客户端都通过 mcpServers 键接收端点。不同客户端的确切字段名称各不相同——有些需要明确指定传输方式，其他则会根据 URL 推断——因此请查阅客户端自己的 MCP 文档。

身份验证采用 OAuth 2.1：客户端会自行注册、打开一次浏览器，之后便会保持授权状态。此流程中无需使用任何 API 密钥。

---

更希望在自己的机器上运行服务并使用自己的 API 密钥？本节其余内容将介绍相关方法。

前置条件

• Node.js >= 18
• Atlas Cloud API Key — 在 atlascloud.ai 免费获取

请参阅 .env.example，了解需要设置的环境变量。

CLI Agent（一行命令安装）

最快的方式——这些 AI 编码 Agent 只需一条命令即可添加服务：

# 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

请先在 shell 中设置 ATLASCLOUD_API_KEY 环境变量。

IDE、编辑器和扩展（JSON 配置）

将以下内容添加到客户端的 MCP 配置中——适用于所有兼容 MCP 的客户端：

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

客户端	添加位置
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 或 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

更喜欢使用 Skills？

如果你更愿意使用 Skills 而非 MCP，我们也提供 Atlas Cloud Skills 套件，适用于 Claude Code 和其他兼容 Skill 的 Agent。

可用工具

工具	描述
atlas_search_docs	按关键词搜索 Atlas Cloud 文档和模型
atlas_list_models	列出可用模型，可按类型（Text/Image/Video/Audio）、子类型（3d/tts/stt/music/lyrics）或关键词筛选
atlas_get_model_info	获取模型详细信息，包括 API 架构、参数和用法示例
atlas_generate_image	使用任意受支持的 Image 模型生成图像和 3D 模型（图像转 3D／文本转 3D）
atlas_generate_video	使用任意受支持的视频模型生成视频
atlas_generate_audio	生成音频——语音（TTS）和音乐／歌曲（Suno、MiniMax Music）——使用任意受支持的音频模型
atlas_transcribe_audio	将语音转录为文本（ASR）——会议、访谈、语音备忘录
atlas_quick_generate	一步生成图像／视频／音频——按关键词自动查找模型、构建参数并提交
atlas_upload_media	上传本地图像、音频、视频或文档，并获取可传递给任意模型的 URL
atlas_chat	与 LLM 模型聊天——根据模型自动选择端点和请求格式（OpenAI chat/responses、Anthropic messages、原生 Gemini）；支持图像／视频／音频输入
atlas_get_prediction	检查生成任务的状态和结果——媒体 URL、转录文本、歌词、封面图和费用
atlas_list_predictions	浏览过往生成任务——找回丢失的预测 ID 或查看之前的结果
atlas_get_balance	获取 API 密钥对应的账户余额和额度摘要
atlas_get_model_usage	获取日期范围内的每日模型用量（请求数、令牌数、图像／视频数量）
atlas_get_model_costs	获取日期范围内的每日模型费用（支出）明细

使用示例

搜索模型

“在 Atlas Cloud 中搜索视频生成模型”

AI 助手会使用 atlas_search_docs 或 atlas_list_models 查找相关模型。

生成图像

“使用 Seedream 生成一张太空中的猫的图像”

助手会：

1. 使用 atlas_list_models 查找 Seedream 图像模型
2. 使用 atlas_get_model_info 获取模型参数
3. 使用 atlas_generate_image 并传入正确的参数

生成视频

“使用 Kling v3 创建一段火箭发射的视频”

助手会：

1. 查找 Kling 视频模型
2. 获取其架构以了解所需参数
3. 使用 atlas_generate_video 并传入适当的参数

上传本地图片以进行编辑或生成视频

“编辑这张图片 /Users/me/photos/cat.jpg，给它加一顶帽子”

助手将：

1. 使用 atlas_upload_media 上传本地文件并获取 URL
2. 查找图像编辑模型
3. 使用上传的 URL 调用 atlas_generate_image

注意：上传的文件仅供 Atlas Cloud 生成任务临时使用。文件可能会定期清理。请勿将其用作永久文件托管服务——滥用可能导致 API 密钥被暂停。

生成语音（TTS）

“用 Seed Audio 朗读这句话：Welcome to Atlas Cloud”

助手将：

1. 使用 atlas_list_models 并设置 type="Audio" 查找 TTS 模型
2. 使用文本调用 atlas_generate_audio 进行合成
3. 使用 atlas_get_prediction 获取生成的音频 URL

生成音乐

“用 Suno 为我的产品演示制作一段 30 秒的欢快合成波音乐”

音乐模型（Suno Chirp、MiniMax Music）属于 Audio 类型模型，因此助手会使用歌曲描述（以及可选的歌词）调用 atlas_generate_audio，然后通过 atlas_get_prediction 获取音频 URL。

转录音频（语音转文本）

“转录这段采访录音：https://example.com/interview.mp3”

助手会使用语音转文本模型（例如 bytedance/seed-asr-2.0）调用 atlas_transcribe_audio 并传入 audio_url，然后通过 atlas_get_prediction 获取转录文本。对于本地文件，助手会先调用 atlas_upload_media 获取 URL。

生成 3D 模型

“用 Hunyuan 3D 将这张产品照片转换为 3D 模型”

3D 模型属于 Image 类型模型，因此助手会使用 image 参数调用 atlas_generate_image，并通过 atlas_get_prediction 获取 GLB/OBJ/USDZ 文件。

与大模型聊天

“请 Qwen 解释量子计算”

助手会使用 Qwen 模型调用 atlas_chat。对于支持图片或视频的模型，将它们附加到消息中后，会自动转换为该模型的协议。

付费前检查调用内容

“准确展示你准备发送给 Kling 的内容，暂时不要执行”

每个生成工具都支持 dry_run: true——它会解析模型、构建请求、根据模型的架构验证请求、输出准确的 JSON 请求体，然后停止。不会提交任何内容，也不会产生费用。当媒体 URL 可能对应多个输入字段，或关键词可能匹配多个模型时，这项功能很有用。

查找之前的生成任务

“我昨天生成了什么？再给我一次视频链接”

助手会使用 atlas_list_predictions 列出最近的任务，并使用 atlas_get_prediction 获取完整结果。若预测 ID 丢失，也可以通过这种方式找回任务——即使提交调用超时，任务仍会继续运行（并产生费用）。

查看余额和用量

“我还剩多少 Atlas Cloud 额度？这个月花了多少？”

助手会使用 atlas_get_balance 查询当前余额，并使用 atlas_get_model_costs 查看费用明细。

开发

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

更多 Atlas Cloud 工具

• 🧰 想从终端使用？ → atlascloud-cli
• 🤖 想在 Claude Code / Cursor 中使用？ → Atlas Cloud MCP Server
• 🎬 想将其用作 Claude Code / Codex / Gemini CLI Skill？ → atlas-cloud-skills
• 🎨 ComfyUI 节点 → atlascloud_comfyui
• 🔁 n8n 节点 → n8n-nodes-atlascloud
• 💬 加入我们的 Discord → discord.gg/MWmMr4q9es
• 🌐 网站 → atlascloud.ai

许可证

MIT