Qwen MCP工具
用于Qwen CLI集成的模型上下文协议服务器。该工具使Claude等AI助手能够通过MCP协议利用Qwen强大的代码分析和大上下文窗口功能。
特性
- 大型上下文窗口：利用Qwen的巨大令牌容量来分析大型文件和整个代码库
- 文件分析：使用
@filename或@directory在查询中包含文件内容的语法 - 沙盒模式：在隔离环境中安全执行代码和运行测试
- 多种型号：支持多种Qwen型号（qwen3-coder plus、qwen3 coder turbo等）
- 灵活的审批模式：使用计划/默认/自动编辑/yolo模式控制工具执行
- MCP协议：与MCP兼容的AI助手无缝集成
先决条件
- Node.js v16或更高版本
- Qwen CLI已安装并配置(qwen代码)
安装
快速设置（最简单-推荐）
使用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"]
}
}
}来源（发展）
- 克隆和安装依赖关系：
git clone
cd qwen-mcp-tool
npm install- 构建项目：
npm run build- 本地链接：
npm link可用工具
问qwen
与Qwen AI交互的主要工具。
参数：
prompt（必填）：您的问题或指示
- 使用 @filename 包含文件内容 - 使用 @directory 包含目录中的所有文件
model（可选）：要使用的型号（qwen3编码器plus、qwen3-编码器turbo等）sandbox（可选）：启用沙盒模式以安全执行代码approvalMode（可选）：控制工具执行审批
- plan：分析工具调用而不执行 - default：提示审批（默认行为） - auto-edit：自动批准文件编辑 - yolo：自动批准所有工具调用
yolo（可选）：审批快捷方式Mode='yolo'allFiles（可选）：将当前目录中的所有文件作为上下文包含在内debug（可选）：启用调试模式
示例：
// Analyze a specific file
{
"prompt": "@src/main.ts Explain what this code does"
}
// Analyze entire codebase
{
"prompt": "@src/ Summarize the architecture of this codebase"
}
// Use specific model with sandbox
{
"prompt": "Run the test suite and fix any failures",
"model": "qwen3-coder-plus",
"sandbox": true,
"approvalMode": "auto-edit"
}拼
简单的回声测试来验证连接。
参数：
prompt（可选）：要回显的消息（默认为“Pong！”）
帮助
显示Qwen CLI帮助信息。
参数： 无
配置
该工具使用以下默认模型：
- 主要的，重要的：qwen3编码器+
- 后备方案：qwen3编码器turbo（如果主编码器达到配额限制，则使用）
您可以通过指定 model 请求中的参数。
使用Claude代码
一旦安装为MCP服务器，您就可以在Claude Code中使用它：
Ask Qwen to analyze the authentication system in @src/auth/Claude将自动使用带有适当参数的ask-qwen工具。
项目结构
qwen-mcp-tool/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── constants.ts # Configuration and constants
│ ├── tools/
│ │ ├── registry.ts # Tool registration system
│ │ ├── ask-qwen.tool.ts # Main Qwen interaction tool
│ │ ├── simple-tools.ts # Utility tools (ping, help)
│ │ └── index.ts # Tool exports
│ └── utils/
│ ├── commandExecutor.ts # Command execution utility
│ ├── qwenExecutor.ts # Qwen CLI wrapper
│ └── logger.ts # Logging utility
├── package.json
├── tsconfig.json
└── README.md运作原理
- MCP服务器通过stdio传输监听工具调用
- 当调用工具时，服务器使用Zod模式验证参数
- 对于
ask-qwen，提示将通过相应的标志传递给Qwen CLI - 文件引用(
@filename)由Qwen的内置文件处理功能处理 - 输出被捕获并返回给MCP客户端
- 如果达到配额限制，服务器将自动回退到turbo模型
与Gemini MCP工具的比较
此工具的灵感来自 gemini mcp工具 但适用于Qwen CLI：
| 功能 | 双子座MCP | Qwen MCP |
|---|---|---|
| 文件引用 | ✅ | ✅ （更高级） |
| 沙盒模式 | ✅ | ✅ |
| 多种型号 | ✅ | ✅ |
| 审批方式 | ❌ | ✅ |
| 目录遍历 | 基本 | 高级（git感知） |
| 多模式支持 | 有限 | 图像、PDF、音频、视频 |
故障排除
“找不到Qwen CLI”
确保Qwen CLI已安装并在PATH中可用：
npm install -g @qwen/cli
# or follow instructions at https://github.com/QwenLM/qwen-code“命令超时”
对于非常大的文件或代码库，分析可能需要比默认的10分钟超时更长的时间。考虑：
- 使用
.qwenignore排除不必要的文件 - 将大型查询分解为更小的块
- 使用
approvalMode: "plan"分析而不执行
“无效的工具参数”
检查您的参数是否与工具架构匹配。使用 Help 工具查看可用选项。
许可证
麻省理工学院
贡献
欢迎投稿！请随时提交问题或拉取请求。
鸣谢
灵感源自 gemini mcp工具 由jamubc。 专为配合使用而设计 Qwen代码.