Alibaba Cloud DashScope — Qwen

@three-ws/alibaba-cloud-mcp

用于在你自己的账户中使用阿里云 DashScope、Qwen 聊天、嵌入和模型发现的 MCP 服务。

安装 · 快速开始 · 工具 · 模型 · three.ws

---

一个 Model Context Protocol 服务，可将阿里云的 Qwen 模型以及 DashScope 账户中的其他内容提供给 Claude Desktop、Claude Code 和 Cursor 等 MCP 客户端。它使用你自己的阿里云 API 密钥，直接调用与 OpenAI 兼容的 DashScope REST API：没有中间后端、没有遥测，也没有模拟数据。

由社区构建，与阿里云无关联。注册表名称：io.github.nirholas/alibaba-cloud。

安装

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

使用 npx 直接运行（无需安装）：

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

快速开始

使用 Claude Code，只需一条命令：

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

或者将此服务添加到 MCP 客户端配置中：

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

要求

1. 一个阿里云账户
2. 一个 DashScope API 密钥，进入 API Keys 并创建一个密钥
3. Node.js ≥ 20

工具

工具	描述
qwen_chat	使用任意 Qwen 模型（qwen-max、qwen-plus、qwen-turbo、qwen-long）完成聊天
qwen_embed	使用 text-embedding-v3 生成文本嵌入（默认 1024 维，最高 2048 维）
qwen_list_models	列出此 DashScope 账户可用的所有模型

模型

模型 ID	用途
qwen-max	最高质量：复杂推理、长文档
qwen-plus	性能均衡（默认）
qwen-turbo	速度最快、成本最低：简单任务
qwen-long	长上下文（最高 1M 个 token）
text-embedding-v3	嵌入、语义搜索、RAG（默认）

环境变量

变量	必填	默认值	描述
DASHSCOPE_API_KEY	是	-	你的 DashScope API 密钥
DASHSCOPE_MODEL_ID	否	qwen-plus	默认聊天模型
DASHSCOPE_EMBED_MODEL_ID	否	text-embedding-v3	默认嵌入模型
DASHSCOPE_BASE_URL	否	国际端点	自定义 DashScope 端点
DASHSCOPE_REGION	否	-	设为 cn 以使用中国端点
DASHSCOPE_TIMEOUT_MS	否	60000	请求超时时间（毫秒）

检查

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

以编程方式使用

包入口（@three-ws/alibaba-cloud-mcp）导出 buildServer()：一个已完整注册但未附加传输层的 McpServer，因此你可以将这三个工具挂载到自己的宿主中，而无需启动二进制文件。调用时会读取 DASHSCOPE_API_KEY，除此之外，注册过程不会产生副作用。如果你想在不使用 MCP 的情况下使用 REST 封装，可以从 @three-ws/alibaba-cloud-mcp/src/dashscope.js 导入 DashScope 客户端（loadConfig、DashScopeClient、DashScopeError）。

// example.mjs: run with: DASHSCOPE_API_KEY=sk-... node example.mjs
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { buildServer } from '@three-ws/alibaba-cloud-mcp';

const server = buildServer();

// What this server exposes, before connecting anything.
for (const [name, tool] of Object.entries(server._registeredTools)) {
  console.log(`${name}: ${tool.title}`);
}

// Serve it over stdio (what the bin does), or attach any other MCP transport.
await server.connect(new StdioServerTransport());

qwen_chat: Qwen Chat
qwen_embed: Qwen Text Embeddings
qwen_list_models: List DashScope Models

---

由 three.ws 构建 · three.ws/blog/three-ws-alibaba-cloud-partnership