悟文-MCP工具

Name: 悟文-MCP工具
Author: Jaggerxtrm

作者：Jaggerxtrm3 星标更新：2025-10-30

安装使用来源：spider==github.com

项目介绍

Qwen MCP 工具

Qwen CLI 集成的 Model Context Protocol 服务器。此工具使像 Claude 这样的AI助手能够通过MCP协议利用Qwen的强大代码分析能力和大上下文窗口功能。

特性

大上下文窗口：利用Qwen的大容量令牌来分析大型文件和整个代码库
文件分析：使用 @filename 或 @directory 语法将文件内容包含在查询中
沙箱模式：在隔离环境中安全地执行代码和运行测试
多种模型：支持各种Qwen模型（如qwen3-coder-plus、qwen3-coder-turbo等）
灵活的批准模式：通过计划/默认/自动编辑/YOLO模式控制工具执行
MCP协议：与兼容MCP的AI助手无缝集成

先决条件

Node.js v16或更高版本
安装并配置了Qwen CLI（qwen-code）

安装

快速设置（最简单 - 推荐）

使用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 <repo-url>
cd qwen-mcp-tool
npm install

构建项目：

npm run build

本地链接：

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 解释这段代码的作用"
}

// 分析整个代码库
{
  "prompt": "@src/ 概述这个代码库的架构"
}

// 使用特定模型并启用沙箱
{
  "prompt": "运行测试套件并修复任何失败",
  "model": "qwen3-coder-plus",
  8 "sandbox": true,
  "approvalMode": "auto-edit"
}

ping

简单的回声测试以验证连接。

参数：

prompt（可选）：要回声的消息（默认为"Pong!"）

帮助

显示Qwen CLI帮助信息。

参数： 无

配置

该工具使用以下默认模型：

主要：qwen3-coder-plus
备用：qwen3-coder-turbo（如果主要模型达到配额限制时使用）

您可以通过在请求中指定 model 参数来覆盖这些默认值。

在Claude Code中的使用

一旦作为MCP服务器安装，您可以在Claude Code中使用它：

让Qwen分析@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，帮助）
│   │   └── index.ts          # 工具导出
│   └── utils/
│       ├── commandExecutor.ts # 命令执行实用工具
│       ├── qwenExecutor.ts    # Qwen CLI包装器
│       └── logger.ts          # 日志记录实用工具
├── package.json
├── tsconfig.json
└── README.md

工作原理

MCP服务器通过stdio传输监听工具调用
当调用工具时，服务器使用Zod模式验证参数
对于 ask-qwen，提示被传递给Qwen CLI，并带有适当的标志
文件引用（@filename）由Qwen内置的文件处理程序处理
输出被捕获并返回给MCP客户端
如果达到配额限制，服务器会自动切换到turbo模型

与Gemini MCP工具的比较

此工具受到gemini-mcp-tool的启发，但针对Qwen CLI进行了调整：

功能	Gemini MCP	Qwen MCP
文件引用	✅	✅（更先进）
沙箱模式	✅	✅
多种模型	✅	✅
批准模式	❌	✅
目录遍历	基本	高级（git感知）
多模态支持	有限	图像、PDF、音频、视频

故障排除

"未找到Qwen CLI"

确保已安装Qwen CLI并在PATH中可用：

npm install -g @qwen/cli
# 或遵循[https://github.com/QwenLM/qwen-code](https://github.com/QwenLM/qwen-code)中的说明

"命令超时"

对于非常大的文件或代码库，分析可能超过默认的10分钟超时时间。考虑：

使用.qwenignore排除不必要的文件
将大型查询分解为较小的部分
使用approvalMode: "plan"进行分析而不执行

"无效的工具参数"

检查您的参数是否符合工具模式。使用帮助工具查看可用选项。

许可证

MIT

贡献

欢迎贡献！请随时提交问题或拉取请求。

致谢

受到jamubc的gemini-mcp-tool的启发。为Qwen Code构建。