内容
<p align="center">
<a href="https://three.ws"><img src="https://three.ws/three-ws-mcp-icon.svg" alt="three.ws" width="88" height="88"></a>
</p>
<h1 align="center">@three-ws/阿里云-mcp</h1>
<p align="center"><strong>阿里云 DashScope 的 MCP 服务器 — 在您自己的账户上使用 Qwen 聊天、嵌入和模型发现。</strong></p>
<p align="center">
<a href="https://www.npmjs.com/package/@three-ws/alibaba-cloud-mcp"><img alt="npm" src="https://img.shields.io/npm/v/@three-ws/alibaba-cloud-mcp?logo=npm&color=cb3837"></a>
<img alt="license" src="https://img.shields.io/npm/l/@three-ws/alibaba-cloud-mcp?color=3b82f6">
<img alt="node" src="https://img.shields.io/node/v/@three-ws/alibaba-cloud-mcp?color=339933&logo=node.js">
<a href="https://three.ws"><img alt="three.ws" src="https://img.shields.io/badge/built%20by-three.ws-000"></a>
</p>
<p align="center">
<a href="#安装">安装</a> ·
<a href="#快速开始">快速开始</a> ·
<a href="#工具">工具</a> ·
<a href="#模型">模型</a> ·
<a href="https://three.ws">three.ws</a>
</p>
---
> 一个 [模型上下文协议](https://modelcontextprotocol.io) 服务器，暴露阿里云的 Qwen 模型 — 以及您 DashScope 账户中的其他模型 — 给 MCP 客户端，如 Claude Desktop、Claude Code 和 Cursor。它直接与 **您的阿里云 API 密钥** 与 DashScope OpenAI 兼容的 REST API 对话：无需中间后端，无需遥测，无需模拟数据。
> 社区构建，与阿里云无关。注册名称：`io.github.nirholas/alibaba-cloud`.
## 安装
```bash
npm install @three-ws/alibaba-cloud-mcp
```
直接使用 `npx` 运行（无需安装）：
```bash
DASHSCOPE_API_KEY=sk-... npx @three-ws/alibaba-cloud-mcp
```
## 快速开始
与 Claude Code 结合使用，只需一条命令：
```bash
claude mcp add alibaba-cloud -e DASHSCOPE_API_KEY=sk-... -- npx -y @three-ws/alibaba-cloud-mcp
```
或将服务器添加到您的 MCP 客户端配置中：
```json
{
"mcpServers": {
"alibaba-cloud": {
"command": "npx",
"args": ["-y", "@three-ws/alibaba-cloud-mcp"],
"env": {
"DASHSCOPE_API_KEY": "sk-..."
}
}
}
}
```
## 要求
1. 一个 [阿里云账户](https://www.alibabacloud.com/)
2. 一个 [DashScope API 密钥](https://bailian.console.alibabacloud.com/) — 导航到 **API 密钥** 并创建一个
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` | 请求超时（毫秒） |
## 检查
```bash
npx -y @modelcontextprotocol/inspector npx @three-ws/alibaba-cloud-mcp
```
---
由 [three.ws](https://three.ws) 构建 · [three.ws/blog/three-ws-alibaba-cloud-partnership](https://three.ws/blog/three-ws-alibaba-cloud-partnership)
## 许可证
版权所有 © 2026 nirholas。保留所有权利。
本软件是专有软件 — 请参阅 [LICENSE](./LICENSE)。 未经版权所有者明确书面许可，不得授予任何权利。
