MCP Server

在 IDE 中直接使用 Atlas Cloud AI 模型，支持 Cursor、Claude Desktop、Claude Code、Codex、Gemini CLI 等主流开发工具。

什么是 MCP？

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

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

Atlas Cloud MCP Server

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

GitHub 仓库：AtlasCloudAI/mcp-server

核心功能

文档搜索 — 在 IDE 中直接搜索 Atlas Cloud 文档、模型和 API 参考
模型发现 — 浏览 300+ 可用 AI 模型，包含价格和能力信息
图片生成 — 使用 Seedream、Qwen-Image、FLUX 等模型生成图片
视频生成 — 使用 Kling、Vidu、Seedance、Wan 等模型生成视频
LLM 对话 — 与 DeepSeek、Qwen、Kimi、GLM 等大语言模型对话（兼容 OpenAI 格式）
动态 Schema — 自动获取每个模型的参数定义，确保 API 调用准确

前置条件

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

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

配置方式

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 使配置生效。

Claude Code

运行以下命令添加 Atlas Cloud MCP Server：

claude mcp add atlascloud -- npx -y atlascloud-mcp

然后设置 API Key 环境变量：

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

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

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"
      }
    }
  }
}

可用工具

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

工具	描述
`atlas_search_docs`	按关键词搜索 Atlas Cloud 文档和模型
`atlas_list_models`	列出所有可用模型，可按类型过滤（Text/Image/Video）
`atlas_get_model_info`	获取模型详情，包括 API Schema、参数说明和使用示例
`atlas_generate_image`	使用任意支持的图片模型生成图片
`atlas_generate_video`	使用任意支持的视频模型生成视频
`atlas_chat`	与大语言模型对话（兼容 OpenAI 格式）
`atlas_get_prediction`	查询图片/视频生成任务的状态和结果

使用示例

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

搜索模型

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

生成图片

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

AI 助手会：

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

生成视频

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

AI 助手会：

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

LLM 对话

"让 DeepSeek V3 解释量子计算"

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

常见问题排查

常见问题

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

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

node --version  # 应为 18.x 或更高版本
npx --version   # 应输出版本号

"Invalid API Key" 错误

验证 API Key 是否正确设置：

echo $ATLASCLOUD_API_KEY  # 应输出您的 API Key

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

MCP Server 在 IDE 中未显示

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

获取帮助

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

什么是 MCP？

Atlas Cloud MCP Server

核心功能

前置条件

配置方式

Cursor

Claude Desktop

Claude Code

Windsurf

Codex

Gemini CLI

Kilo Code

OpenCode

可用工具

使用示例

搜索模型

生成图片

生成视频

LLM 对话

常见问题排查

常见问题

获取帮助

常见问题

MCP Server 免费吗？

可以访问哪些 AI 模型？

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

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

我的 API Key 安全吗？

本页目录