AI导哈

代码分析工具

Qwen MCP Tool是一个用于代码分析和大型上下文窗口处理的工具，支持多种Qwen模型，提供沙盒模式和灵活的批准模式。

  • by Jaggerxtrm
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 Jaggerxtrm/qwen-mcp-tool

使用说明

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"]
    }
  }
}

来源（发展）

  1. 克隆和安装依赖关系：
git clone <repo-url>
cd qwen-mcp-tool
npm install
  1. 构建项目：
npm run build
  1. 本地链接：
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

运作原理

  1. MCP服务器通过stdio传输监听工具调用
  2. 当调用工具时，服务器使用Zod模式验证参数
  3. 对于 ask-qwen，提示将通过相应的标志传递给Qwen CLI
  4. 文件引用(@filename)由Qwen的内置文件处理功能处理
  5. 输出被捕获并返回给MCP客户端
  6. 如果达到配额限制，服务器将自动回退到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代码.

相关 MCP