Alibaba Cloud DashScope — Qwen: Claude Code MCP server
Connect a DashScope account to an MCP client for Qwen chat, text embeddings, and account-specific model discovery.
claude mcp add --env DASHSCOPE_API_KEY=<DASHSCOPE_API_KEY> --env DASHSCOPE_MODEL_ID=<DASHSCOPE_MODEL_ID> --env DASHSCOPE_EMBED_MODEL_ID=<DASHSCOPE_EMBED_MODEL_ID> --env DASHSCOPE_BASE_URL=<DASHSCOPE_BASE_URL> --env DASHSCOPE_REGION=<DASHSCOPE_REGION> --transport stdio alibaba-cloud-mcp -- npx -y @three-ws/alibaba-cloud-mcpWhat Alibaba Cloud DashScope — Qwen does
The server uses your Alibaba Cloud account to reach DashScope. Its three tools let an agent chat with a Qwen model through qwen_chat, create embeddings with qwen_embed, or inspect available account models using qwen_list_models.
You need a DashScope API key and Node.js ≥ 20. Set DASHSCOPE_MODEL_ID or DASHSCOPE_EMBED_MODEL_ID to choose the default chat or embedding model. DASHSCOPE_REGION=cn selects the China endpoint; without DASHSCOPE_API_KEY, the server cannot make DashScope requests.
It works with Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, and Zed. For a custom MCP host, the package exports buildServer(); its DashScope client can also be imported separately.
What it helps with
- send a prompt to a Qwen model from an MCP client
- create text embeddings through DashScope
- inspect models available to a DashScope account
- set a different default chat model with an environment variable
Example prompts for the agent
- Ask Qwen to explain the failure in
auth.test.ts. - Create embeddings for the text in
docs/search.md. - List the models available in my DashScope account.
How to install Alibaba Cloud DashScope — Qwen
Platform CLI
claude mcp add --env DASHSCOPE_API_KEY=<DASHSCOPE_API_KEY> --env DASHSCOPE_MODEL_ID=<DASHSCOPE_MODEL_ID> --env DASHSCOPE_EMBED_MODEL_ID=<DASHSCOPE_EMBED_MODEL_ID> --env DASHSCOPE_BASE_URL=<DASHSCOPE_BASE_URL> --env DASHSCOPE_REGION=<DASHSCOPE_REGION> --transport stdio alibaba-cloud-mcp -- npx -y @three-ws/alibaba-cloud-mcpReplace <…> with your own values
Platform CLI
codex mcp add alibaba-cloud-mcp --env DASHSCOPE_API_KEY=<DASHSCOPE_API_KEY> --env DASHSCOPE_MODEL_ID=<DASHSCOPE_MODEL_ID> --env DASHSCOPE_EMBED_MODEL_ID=<DASHSCOPE_EMBED_MODEL_ID> --env DASHSCOPE_BASE_URL=<DASHSCOPE_BASE_URL> --env DASHSCOPE_REGION=<DASHSCOPE_REGION> -- npx -y @three-ws/alibaba-cloud-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"alibaba-cloud-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/alibaba-cloud-mcp"
],
"env": {
"DASHSCOPE_API_KEY": "<DASHSCOPE_API_KEY>",
"DASHSCOPE_MODEL_ID": "<DASHSCOPE_MODEL_ID>",
"DASHSCOPE_EMBED_MODEL_ID": "<DASHSCOPE_EMBED_MODEL_ID>",
"DASHSCOPE_BASE_URL": "<DASHSCOPE_BASE_URL>",
"DASHSCOPE_REGION": "<DASHSCOPE_REGION>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"alibaba-cloud-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/alibaba-cloud-mcp"
],
"env": {
"DASHSCOPE_API_KEY": "<DASHSCOPE_API_KEY>",
"DASHSCOPE_MODEL_ID": "<DASHSCOPE_MODEL_ID>",
"DASHSCOPE_EMBED_MODEL_ID": "<DASHSCOPE_EMBED_MODEL_ID>",
"DASHSCOPE_BASE_URL": "<DASHSCOPE_BASE_URL>",
"DASHSCOPE_REGION": "<DASHSCOPE_REGION>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e DASHSCOPE_API_KEY=<DASHSCOPE_API_KEY> -e DASHSCOPE_MODEL_ID=<DASHSCOPE_MODEL_ID> -e DASHSCOPE_EMBED_MODEL_ID=<DASHSCOPE_EMBED_MODEL_ID> -e DASHSCOPE_BASE_URL=<DASHSCOPE_BASE_URL> -e DASHSCOPE_REGION=<DASHSCOPE_REGION> alibaba-cloud-mcp npx -y @three-ws/alibaba-cloud-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Alibaba Cloud DashScope — Qwen
How do I install Alibaba Cloud DashScope — Qwen in Claude Code?
Run claude mcp add alibaba-cloud -e DASHSCOPE_API_KEY=<DASHSCOPE_API_KEY> -- npx -y @three-ws/alibaba-cloud-mcp. You need a DashScope API key.
What does Alibaba Cloud DashScope — Qwen do?
It gives an MCP client tools for Qwen chat, text embeddings, and listing models available in a DashScope account.
What does the server need to run?
You need an Alibaba Cloud account, a DashScope API key, and Node.js ≥ 20.
