Qwen MCP Tool

🚀 Qwen MCP Tool

このツールは、Qwen CLIと統合するためのModel Context Protocolサーバーです。MCPプロトコルを通じて、ClaudeなどのAIアシスタントがQwenの強力なコード分析機能と大規模なコンテキストウィンドウ機能を活用できるようにします。

✨ 主な機能

• 大規模コンテキストウィンドウ：Qwenの大量のトークン容量を活用して、大きなファイルやコードベース全体を分析できます。
• ファイル分析：@filename または @directory 構文を使用して、クエリにファイル内容を含めることができます。
• サンドボックスモード：分離された環境で安全にコードを実行し、テストを実行できます。
• 複数のモデル：様々なQwenモデル（qwen3-coder-plus、qwen3-coder-turboなど）をサポートしています。
• 柔軟な承認モード：plan/default/auto-edit/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

この1つのコマンドですべてが自動的に設定されます！

グローバルインストール

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. クォータ制限に達した場合、サーバーは自動的にターボモデルにフォールバックします。

Gemini MCP Toolとの比較

このツールは gemini-mcp-tool にインスパイアされていますが、Qwen CLIに適合するように調整されています。

トラブルシューティング

"Qwen CLI not found"

Qwen CLIがインストールされ、PATHに含まれていることを確認してください。

npm install -g @qwen/cli
# または https://github.com/QwenLM/qwen-code の手順に従ってください。

"Command timed out"

非常に大きなファイルやコードベースの場合、分析にデフォルトの10分のタイムアウトよりも時間がかかることがあります。以下のことを検討してください。

• .qwenignore を使用して不要なファイルを除外する。
• 大きなクエリを小さなチャンクに分割する。
• approvalMode: "plan" を使用して実行せずに分析する。

"Invalid tool arguments"

引数がツールスキーマと一致することを確認してください。使用可能なオプションを表示するには、Help ツールを使用してください。

📄 ライセンス

MIT

貢献

貢献は大歓迎です！問題やプルリクエストを自由に提出してください。

クレジット

このツールはjamubcによる gemini-mcp-tool にインスパイアされています。 Qwen Code とともに使用するために構築されています。