Qwen MCP Tool

🚀 Qwen MCP 工具

Qwen MCP 工具是一個用於 Qwen CLI 集成的模型上下文協議服務器。該工具允許像 Claude 這樣的 AI 助手通過 MCP 協議，利用 Qwen 強大的代碼分析和大上下文窗口能力。

🚀 快速開始

Qwen MCP 工具為 AI 助手與 Qwen 的集成提供了便利。在使用前，你需要確保滿足一定的前提條件，並按照相應的步驟進行安裝。

✨ 主要特性

• 大上下文窗口：利用 Qwen 巨大的令牌容量來分析大文件和整個代碼庫。
• 文件分析：使用 @filename 或 @directory 語法在查詢中包含文件內容。
• 沙盒模式：在隔離環境中安全地執行代碼和運行測試。
• 多模型支持：支持各種 Qwen 模型（如 qwen3-coder-plus、qwen3-coder-turbo 等）。
• 靈活的審批模式：通過 plan/default/auto-edit/yolo 模式控制工具執行。
• MCP 協議：與支持 MCP 的 AI 助手無縫集成。

📦 安裝指南

快速設置（最簡單 - 推薦）

使用 Claude Code 內置的 MCP 安裝程序：

claude mcp add qwen-cli -- npx -y @jaggerxtrm/qwen-mcp-tool

這一條命令將自動完成所有配置！

通過全局安裝

通過 npm 進行安裝：

npm install -g @jaggerxtrm/qwen-mcp-tool

然後添加到 Claude Code MCP 設置（~/.config/claude/mcp_settings.json）：

{
  "mcpServers": {
    "qwen-cli": {
      "command": "qwen-mcp-tool"
    }
  }
}

通過 npx（手動配置）

手動配置以使用 npx 而無需安裝：

{
  "mcpServers": {
    "qwen-cli": {
      "command": "npx",
      "args": ["-y", "@jaggerxtrm/qwen-mcp-tool"]
    }
  }
}

從源代碼安裝（開發用途）

1. 克隆倉庫並安裝依賴：

git clone <repo-url>
cd qwen-mcp-tool
npm install

2. 構建項目：

npm run build

3. 本地鏈接：

npm link

💻 使用示例

可用工具

ask-qwen

與 Qwen AI 交互的主要工具。 參數：

• prompt（必需）：你的問題或指令。
  • 使用 @filename 包含文件內容。
  • 使用 @directory 包含目錄中的所有文件。
• model（可選）：要使用的模型（如 qwen3-coder-plus、qwen3-coder-turbo 等）。
• sandbox（可選）：啟用沙盒模式以安全執行代碼。
• approvalMode（可選）：控制工具執行審批。
  • plan：分析工具調用但不執行。
  • default：提示進行審批（默認行為）。
  • auto-edit：自動批准文件編輯。
  • yolo：自動批准所有工具調用。
• yolo（可選）：approvalMode='yolo' 的快捷方式。
• allFiles（可選）：將當前目錄中的所有文件作為上下文包含。
• debug（可選）：啟用調試模式。

示例：

// 分析特定文件
{
  "prompt": "@src/main.ts Explain what this code does"
}

// 分析整個代碼庫
{
  "prompt": "@src/ Summarize the architecture of this codebase"
}

// 使用特定模型並啟用沙盒模式
{
  "prompt": "Run the test suite and fix any failures",
  "model": "qwen3-coder-plus",
  "sandbox": true,
  "approvalMode": "auto-edit"
}

ping

用於驗證連接的簡單回顯測試。 參數：

• prompt（可選）：要回顯的消息（默認為 "Pong!"）。

Help

顯示 Qwen CLI 幫助信息。 參數：無

📚 詳細文檔

配置

該工具使用以下默認模型：

• 主模型：qwen3-coder-plus
• 備用模型：qwen3-coder-turbo（當主模型達到配額限制時使用）

你可以在請求中指定 model 參數來覆蓋這些默認設置。

與 Claude Code 配合使用

安裝為 MCP 服務器後，你可以在 Claude Code 中使用它：

Ask Qwen to analyze the authentication system in @src/auth/

Claude 將自動使用 ask-qwen 工具並傳遞適當的參數。

項目結構

qwen-mcp-tool/
├── src/
│   ├── index.ts              # MCP 服務器入口點
│   ├── constants.ts          # 配置和常量
│   ├── tools/
│   │   ├── registry.ts       # 工具註冊系統
│   │   ├── ask-qwen.tool.ts  # 主要的 Qwen 交互工具
│   │   ├── simple-tools.ts   # 實用工具（ping、help）
│   │   └── index.ts          # 工具導出
│   └── utils/
│       ├── commandExecutor.ts # 命令執行實用工具
│       ├── qwenExecutor.ts    # Qwen CLI 包裝器
│       └── logger.ts          # 日誌記錄實用工具
├── package.json
├── tsconfig.json
└── README.md

工作原理

1. MCP 服務器通過 stdio 傳輸監聽工具調用。
2. 當調用工具時，服務器使用 Zod 模式驗證參數。
3. 對於 ask-qwen，提示將通過適當的標誌傳遞給 Qwen CLI。
4. 文件引用（@filename）由 Qwen 內置的文件處理功能處理。
5. 捕獲輸出並返回給 MCP 客戶端。
6. 如果達到配額限制，服務器將自動切換到 turbo 模型。

與 Gemini MCP 工具的比較

本工具受 gemini-mcp-tool 啟發，但針對 Qwen CLI 進行了調整：

故障排除

"Qwen CLI 未找到"

確保 Qwen CLI 已安裝並在你的 PATH 中可用：

npm install -g @qwen/cli
# 或遵循 https://github.com/QwenLM/qwen-code 中的說明

"命令超時"

對於非常大的文件或代碼庫，分析可能需要比默認的 10 分鐘超時時間更長的時間。可以考慮：

• 使用 .qwenignore 排除不必要的文件。
• 將大查詢拆分為較小的塊。
• 使用 approvalMode: "plan" 進行分析而不執行。

"無效的工具參數"

檢查你的參數是否符合工具模式。使用 Help 工具查看可用選項。

📄 許可證

本項目採用 MIT 許可證。

貢獻

歡迎貢獻！請隨時提交問題或拉取請求。

鳴謝

本項目受 jamubc 的 gemini-mcp-tool 啟發，專為與 Qwen Code 配合使用而構建。