@three-ws/alibaba-cloud-mcp

MCP server for Alibaba Cloud DashScope — Qwen chat, embeddings, and model discovery on your own account.

Install · Quick start · Tools · Models · three.ws

---

A Model Context Protocol server that exposes Alibaba Cloud's Qwen models — and anything else in your DashScope account — to MCP clients such as Claude Desktop, Claude Code, and Cursor. It talks directly to the DashScope OpenAI-compatible REST API with your own Alibaba Cloud API key: no intermediary backend, no telemetry, no mock data.

Community-built and not affiliated with Alibaba Cloud. Registry name: io.github.nirholas/alibaba-cloud.

Install

npm install @three-ws/alibaba-cloud-mcp

Run it directly with npx (no install needed):

DASHSCOPE_API_KEY=sk-... npx @three-ws/alibaba-cloud-mcp

Quick start

With Claude Code, one command:

claude mcp add alibaba-cloud -e DASHSCOPE_API_KEY=sk-... -- npx -y @three-ws/alibaba-cloud-mcp

Or add the server to your MCP client config:

{
  "mcpServers": {
    "alibaba-cloud": {
      "command": "npx",
      "args": ["-y", "@three-ws/alibaba-cloud-mcp"],
      "env": {
        "DASHSCOPE_API_KEY": "sk-..."
      }
    }
  }
}

Requirements

1. An Alibaba Cloud account
2. A DashScope API key — navigate to API Keys and create one
3. Node.js ≥ 20

Tools

Tool	Description
qwen_chat	Chat completion with any Qwen model (qwen-max, qwen-plus, qwen-turbo, qwen-long)
qwen_embed	Text embeddings via text-embedding-v3 (1024-dim default, up to 2048)
qwen_list_models	List all models available on this DashScope account

Models

Model ID	Use
qwen-max	Highest quality — complex reasoning, long documents
qwen-plus	Balanced performance (default)
qwen-turbo	Fastest and cheapest — simple tasks
qwen-long	Long context (up to 1M tokens)
text-embedding-v3	Embeddings, semantic search, RAG (default)

Environment variables

Variable	Required	Default	Description
DASHSCOPE_API_KEY	yes	—	Your DashScope API key
DASHSCOPE_MODEL_ID	no	qwen-plus	Default chat model
DASHSCOPE_EMBED_MODEL_ID	no	text-embedding-v3	Default embedding model
DASHSCOPE_BASE_URL	no	International endpoint	Custom DashScope endpoint
DASHSCOPE_REGION	no	—	Set to cn for the China endpoint
DASHSCOPE_TIMEOUT_MS	no	60000	Request timeout in ms

Inspect

npx -y @modelcontextprotocol/inspector npx @three-ws/alibaba-cloud-mcp

---

Built by three.ws · three.ws/blog/three-ws-alibaba-cloud-partnership