Alibaba Cloud DashScope — Qwen について
alibaba-cloud-mcp は、Alibaba Cloud DashScope 向けの MCP サーバーです。ユーザー自身の API キーで OpenAI 互換 REST API を直接呼び出し、Qwen によるチャット、埋め込み、モデル一覧の取得を提供します。コミュニティによる開発で、Alibaba Cloud とは提携していません。
主な機能
- 01複数の Qwen モデルによるチャット補完
- 02text-embedding-v3 によるテキスト埋め込み
- 03アカウントで利用可能なモデルの一覧取得
- 04中間バックエンドを介さない直接の API 呼び出し
活用シーン
- 01Claude Code や Cursor から Qwen モデルを利用する
- 02セマンティック検索や RAG 用の埋め込みを生成する
- 03アカウントで利用できる DashScope モデルを確認する
MCP 対応
このサーバーは、qwen_chat、qwen_embed、qwen_list_models の 3 つのツールを MCP ツールとして公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @three-ws/alibaba-cloud-mcpDASHSCOPE_API_KEYシークレットDashScope API key. Create one at https://bailian.console.alibabacloud.com/ → API Keys.DASHSCOPE_MODEL_IDDefault chat model id. Options: qwen-max, qwen-plus (default), qwen-turbo, qwen-long.DASHSCOPE_EMBED_MODEL_IDDefault embedding model id. Defaults to text-embedding-v3.DASHSCOPE_BASE_URLCustom DashScope endpoint. Defaults to international (dashscope-intl.aliyuncs.com).DASHSCOPE_REGIONSet to 'cn' to use the China endpoint (dashscope.aliyuncs.com). Ignored if DASHSCOPE_BASE_URL is set.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
3掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| model | string | いいえ | モデル ID を上書きします。選択肢:qwen-max、qwen-plus(既定)、qwen-turbo、qwen-long、qwen-max-latest。 |
| top_p | number | いいえ | 核サンプリングの確率質量。 |
| messages | array | はい | ここまでの会話。古い順。 |
| max_tokens | integer | いいえ | 生成する最大トークン数。 |
| temperature | number | いいえ | サンプリング温度。0 は貪欲的/決定的な生成を示します。 |
詳細
@three-ws/alibaba-cloud-mcp
ご自身のアカウントで Alibaba Cloud DashScope、Qwen チャット、埋め込み、モデルの検出を利用するための MCP サーバーです。
インストール · クイックスタート · ツール · モデル · three.ws
Model Context Protocol サーバーです。Alibaba Cloud の Qwen モデルと、DashScope アカウントで利用できるその他すべての機能を、Claude Desktop、Claude Code、Cursor などの MCP クライアントに公開します。ご自身の Alibaba Cloud API キーを使用して、DashScope の OpenAI 互換 REST API に直接接続します。仲介バックエンドも、テレメトリーも、モックデータもありません。
コミュニティによって開発されており、Alibaba Cloud とは提携していません。レジストリ名:
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-..."
}
}
}
}
必要条件
- Alibaba Cloud アカウント
- DashScope API キーにアクセスし、API Keys を選択して作成します
- 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トークン) |
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 です。そのため、バイナリを起動する代わりに、ご自身のホスト内に3つのツールをマウントできます。呼び出し時に DASHSCOPE_API_KEY を読み込みます。それ以外の登録処理に副作用はありません。MCP を使わずに REST ラッパーのみを利用する場合は、DashScope クライアントを @three-ws/alibaba-cloud-mcp/src/dashscope.js からインポートできます(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
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。