MCP Server

什么是 MCP？

模型上下文协议（MCP，Model Context Protocol） 是由 Anthropic 开发的开放标准，它使 AI 助手能够以标准化的方式与外部工具和数据源进行交互。MCP 就像一个通用适配器 —— 让 Cursor、Claude Desktop、Claude Code 等 AI 驱动的 IDE 能够无缝连接第三方服务、API 和数据。

通过 MCP，开发者可以将 AI 助手的能力扩展到代码补全之外：搜索文档、生成图片、视频、音频和 3D 模型、与大语言模型交互等等 —— 一切操作都可以在编程环境中通过自然语言命令完成。

Atlas Cloud MCP Server

Atlas Cloud 提供了官方 MCP Server（atlascloud-mcp npm 包），将 Atlas Cloud AI API 平台的全部能力直接带入您的 IDE。平台提供 400+ AI 模型，涵盖图片、视频、3D、音频（TTS）和大语言模型，让您无需在浏览器标签页之间切换或手动编写 API 调用代码。

GitHub 仓库：AtlasCloudAI/mcp-server

支持的模型

• 🎬 视频 — Seedance 2.0 · Kling 3 · Sora 2 · Veo 3.1 · HappyHorse 1 · Grok Imagine 1.5 · Wan 2.7
• 🎨 图片 — Nano Banana 2/Pro · GPT Image 2 · Flux 2 · Seedream 5
• 🧊 3D — Hunyuan 3D 图生 3D / 文生 3D
• 💬 LLM — Claude · GPT · DeepSeek · MiniMax · Kimi · GLM · Qwen
• 🔊 音频（TTS） — Seed Audio · xAI/Grok TTS · ElevenLabs

访问我们的模型页面浏览完整目录。

核心功能

• 文档搜索 — 在 IDE 中直接搜索 Atlas Cloud 文档、模型和 API 参考
• 模型发现 — 列出并浏览 400+ 可用 AI 模型，包含价格和能力信息，可按类型过滤（Text/Image/Video/Audio）
• 图片生成 — 使用 Nano Banana、GPT Image 2、Flux 2、Seedream 等模型生成图片
• 视频生成 — 使用 Seedance、Kling、Sora、Veo、Wan 等模型生成视频
• 3D 生成 — 通过 Hunyuan 3D 将文本或照片转换为 3D 模型（GLB/OBJ/USDZ）
• 音频生成（TTS） — 使用 Seed Audio、xAI/Grok TTS、ElevenLabs 等合成语音
• 快速生成 — 一步完成图片/视频/音频生成，按关键词自动匹配合适的模型并构建参数
• 媒体上传 — 上传本地文件获取 URL，用于图片编辑或图生视频工作流
• LLM 对话 — 与 Claude、GPT、DeepSeek、Qwen、Kimi、GLM 等大语言模型对话（兼容 OpenAI 格式）
• 余额与用量 — 通过 Atlas Cloud Public API 查询账户余额、每日用量和费用明细
• 动态 Schema — 自动获取每个模型的参数定义，并在提交之前校验参数，让无效请求快速失败而不消耗积分

前置条件

在配置 Atlas Cloud MCP Server 之前，请确保您已准备好：

• Node.js 18 或更高版本 — 下载 Node.js
• Atlas Cloud API Key — 在 atlascloud.ai 注册并获取

配置方式

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

然后设置 API Key 环境变量：

export ATLASCLOUD_API_KEY="your-api-key-here"

要在终端会话之间持久化 API Key，请将 export 命令添加到 shell 配置文件中（~/.bashrc、~/.zshrc 等）。

Cursor

打开或创建文件 ~/.cursor/mcp.json，添加以下配置：

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

重启 Cursor 使配置生效。

Claude Desktop

打开配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

添加 MCP Server 配置：

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

重启 Claude Desktop 使配置生效。

Windsurf

将以下内容添加到 Windsurf 的 MCP 配置中：

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

Codex

推荐使用上文的一键安装命令，也可以打开或创建 Codex 配置文件 ~/.codex/config.toml，添加以下配置：

[mcp_servers.atlascloud]
command = "npx"
args = ["-y", "atlascloud-mcp"]

[mcp_servers.atlascloud.env]
ATLASCLOUD_API_KEY = "your-api-key-here"

Gemini CLI

推荐使用上文的一键安装命令，也可以打开或创建 Gemini 配置文件 ~/.gemini/settings.json，添加以下配置：

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

Kilo Code

打开或创建项目级配置文件 .kilocode/mcp.json，添加以下配置：

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

OpenCode

打开或创建 OpenCode 配置文件 opencode.json，添加以下配置：

{
  "mcp": {
    "atlascloud": {
      "type": "local",
      "command": ["npx", "-y", "atlascloud-mcp"],
      "enabled": true,
      "environment": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

其他 MCP 客户端

同样的 JSON 配置适用于所有兼容 MCP 的客户端：

可用工具

Atlas Cloud MCP Server 提供 13 个工具供 AI 助手使用：

注意：余额、用量和费用工具由 Atlas Cloud Public API（https://api.atlascloud.ai/public/v1）提供支持，让您无需离开 IDE 即可审计消费和配额。

使用示例

配置完成后，您可以通过自然语言与 Atlas Cloud 交互：

搜索模型

• "搜索 Atlas Cloud 上的视频生成模型"
• "列出所有图片生成模型及其定价"
• "查看 DeepSeek V3 模型的详细信息"

生成图片

"用 Seedream 生成一张太空猫的图片"

AI 助手会：

1. 用 atlas_list_models 查找 Seedream 图片模型
2. 用 atlas_get_model_info 获取模型参数
3. 用 atlas_generate_image 配合正确参数生成图片

生成视频

"用 Kling v3 创建一段火箭发射的视频"

AI 助手会：

1. 查找 Kling 视频模型
2. 获取模型 Schema 了解所需参数
3. 用 atlas_generate_video 配合正确参数生成视频

上传本地图片用于编辑或视频生成

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

AI 助手会：

1. 用 atlas_upload_media 上传本地文件并获取 URL
2. 查找一个图片编辑模型
3. 用 atlas_generate_image 配合上传后的 URL 生成图片

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

生成语音（TTS）

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

AI 助手会：

1. 用 atlas_list_models 配合 type="Audio" 查找 TTS 模型
2. 用 atlas_generate_audio 合成指定文本的语音
3. 用 atlas_get_prediction 获取生成的音频 URL

生成 3D 模型

"用 Hunyuan 3D 把这张产品照片变成 3D 模型"

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

LLM 对话

"让 DeepSeek V3 解释量子计算"

AI 助手会使用 atlas_chat 调用 DeepSeek 模型。

查询余额和用量

"我的 Atlas Cloud 还剩多少额度？这个月花了多少？"

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

常见问题排查

常见问题

运行 npx 时出现 "Command not found" 错误

确保已安装 Node.js 18+ 且 npx 在 PATH 中可用：

node --version  # Should be 18.x or higher
npx --version   # Should output a version number

"Invalid API Key" 错误

验证 API Key 是否正确设置：

echo $ATLASCLOUD_API_KEY  # Should output your key

如果为空，请重新设置并确保没有多余的空格或引号。

MCP Server 在 IDE 中未显示

• 确保在添加配置后已重启 IDE
• 仔细检查配置文件中的 JSON 语法
• 确认配置文件位于 IDE 对应的正确路径

获取帮助

• GitHub Issues：AtlasCloudAI/mcp-server/issues
• Atlas Cloud 客服：联系我们

更多 Atlas Cloud 工具

偏好其他集成方式？Atlas Cloud 还提供：

• CLI — 在终端中使用 Atlas Cloud：atlascloud-cli
• Skills — 面向 Claude Code 及其他兼容 Skills 的 Agent 的 Skills 包：atlas-cloud-skills
• ComfyUI 节点 — atlascloud_comfyui
• n8n 节点 — n8n-nodes-atlascloud

常见问题

MCP Server 免费吗？

MCP Server 本身是免费开源的（MIT 许可证）。您只需为使用的 Atlas Cloud API 按模型付费。查看我们的模型定价了解详情。

可以访问哪些 AI 模型？

您可以访问 Atlas Cloud 上所有 400+ 模型，包括视频模型（Seedance、Kling、Sora、Veo、Wan）、图片模型（Nano Banana、GPT Image、FLUX、Seedream）、3D 模型（Hunyuan 3D）、TTS 模型（Seed Audio、xAI/Grok TTS、ElevenLabs）以及大语言模型（Claude、GPT、DeepSeek、Qwen、Kimi、GLM、MiniMax）。访问我们的模型页面查看完整列表。

除了 Node.js 还需要安装其他东西吗？

不需要。MCP Server 通过 npm 分发，使用 npx 运行，它会自动下载并执行包。无需全局安装。

可以在其他 IDE 中使用 MCP Server 吗？

MCP Server 适用于任何支持模型上下文协议的 IDE 或应用程序，包括 Cursor、Claude Desktop、Claude Code、Codex、Gemini CLI、Goose、Windsurf、Kilo Code、OpenCode、Cline、Continue、VS Code (Copilot)、Trae、JetBrains IDEs、ChatGPT Desktop、Amazon Q Developer 和 Roo Code。

我的 API Key 安全吗？

您的 API Key 存储在 IDE 的本地配置文件中，仅发送到 Atlas Cloud 的 API 端点。MCP Server 不会收集、记录或向任何第三方服务传输您的 API Key。