MCP 伺服器

什麼是 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 對話 — 與 GPT、DeepSeek、Qwen、GLM 等大型語言模型對話（相容 OpenAI 格式）
• 動態 Schema — 自動取得每個模型的參數定義，確保 API 呼叫準確

前置需求

在設定 Atlas Cloud MCP Server 之前，請確保您已準備好：

• Node.js 18 或更高版本 — 下載 Node.js
• Atlas Cloud API 金鑰 — 在 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 金鑰設定為環境變數：

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

要在終端機工作階段之間持久保存 API 金鑰，請將 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 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 搭配正確參數生成影片

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 金鑰是否正確設定：

echo $ATLASCLOUD_API_KEY  # 應輸出您的 API Key

如果為空，請重新設定並確保沒有多餘的空格或引號。

MCP Server 未在 IDE 中顯示

• 確保在新增設定後已重新啟動 IDE
• 仔細檢查設定檔中的 JSON 語法
• 確認設定檔位於 IDE 對應的正確路徑

取得協助

• GitHub Issues：AtlasCloudAI/mcp-server/issues
• Atlas Cloud 客服：聯絡我們

常見問題

MCP Server 是否免費使用？

MCP Server 本身是免費且開源的（MIT 授權）。您只需根據使用的模型支付 Atlas Cloud API 的費用。詳情請查看我們的模型定價。

我可以存取哪些 AI 模型？

您可以存取 Atlas Cloud 上所有 300+ 模型，包括來自 OpenAI、Anthropic、DeepSeek、Google、Meta、Mistral、字節跳動（Seedream、Kling）、阿里巴巴（Qwen）等的模型。請造訪我們的模型頁面以取得完整列表。

除了 Node.js 還需要安裝其他東西嗎？

不需要。MCP Server 透過 npm 分發，使用 npx 執行，它會自動下載並執行套件。不需要全域安裝。

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

MCP Server 適用於任何支援模型上下文協議的 IDE 或應用程式。目前支援：Cursor、Claude Desktop、Claude Code、Windsurf、Codex、Gemini CLI、Kilo Code 和 OpenCode。

我的 API 金鑰安全嗎？

您的 API 金鑰儲存在 IDE 的本機設定檔中，僅發送到 Atlas Cloud 的 API 端點。MCP Server 不會收集、記錄或將您的 API 金鑰傳輸給任何第三方服務。