qwen-cli-mcp

MCP-сервер, который делегирует задачи кодирования вашему локально установленному Qwen Code CLI.

Он оборачивает настоящий бинарник qwen вместо того, чтобы включать собственную копию агента, поэтому каждый вызов наследует вашу аутентификацию qwen, модели, MCP-серверы и настройки. Ничего из вашего стека моделей здесь не дублируется, и сервер не расходится с реальностью, когда вы обновляете qwen.

Родственный проект pi-cli-mcp — та же архитектура, те же принципы, за рулём qwen. Авторитетный дизайн-документ — SPEC.md.

Используйте его, когда ваш основной агент (Claude Code, Cursor, сам pi, любой MCP-клиент) должен передать работу qwen: второе мнение от другого семейства моделей, расследование, которое вы хотите держать вне основного контекстного окна, или параллельная работа.

Установка

npx -y qwen-cli-mcp         # no install
npm install -g qwen-cli-mcp # or global

Требуется Node ≥ 22 и рабочий qwen в PATH (npm i -g @qwen-code/qwen-code).

Claude Code

claude mcp add-json qwen -s user '{
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "qwen-cli-mcp"],
  "timeout": 3600000
}'
claude mcp list | grep '^qwen:'    # expect: ✔ Connected

Щедрый timeout важен: реальная делегированная задача может выполняться минутами.

Любой другой MCP-клиент

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

Держите имя сервера коротким (qwen): оно становится частью имён инструментов, которые видит ваша модель.

⚠️ Режим одобрения по умолчанию — yolo. Делегирование полезно только тогда, когда делегат может действовать, поэтому этот сервер запускает qwen с полным одобрением инструментов по умолчанию — внутри cwd, от вашего имени. Сузьте его с помощью QWEN_MCP_APPROVAL_MODE, approval_mode на каждый вызов или allowed_tools. Для работы только с анализом передавайте allowlist-ы вида allowed_tools: "read,grep,ls".

Инструменты

qwen

Что возвращается

Только финальный результат qwen плюс агрегированная статистика — никогда не транскрипт, аргументы инструментов или сырой stdout:

[session: 0927adc5-a840-4b68-93ca-5ca344c9fafb]

Refactored retry() in src/http.rs; all 12 tests pass.

---
qwen: qwen3-coder-plus · 6 turns · 5 tool calls: bash×2, read×2, edit · 18k in / 310 out · 41s

Ответ — это конверт result, который qwen выдаёт в конце хода — никаких догадок по выбору ответа. Конверт ошибки (error_max_turns, error_during_execution) приводит к провалу вызова, сохраняя всё, что qwen успел сказать, так что работа остаётся возобновляемой. Поток, завершившийся без конверта результата, сообщается как сломанный, никогда не подменяется сырым выводом.

Сессии

qwen возвращает идентификатор сессии; qwen_reply возобновляет её с --resume. Беседа живёт в собственном хранилище сессий qwen, поэтому продолжения работают после перезапуска этого сервера — карта «сессия → каталог» сохраняется в ~/.local/state/qwen-mcp/sessions.json.

Одновременные ответы на одну сессию сериализуются в рамках одного серверного процесса: два процесса qwen, пишущих в один файл сессии, испортили бы его. Предостережение о межпроцессном взаимодействии: если вы запускаете два MCP-клиента против двух серверных процессов и оба отвечают на один и тот же идентификатор сессии одновременно, ничто их не сериализует. На практике сессией владеет один клиент; для жёсткой гарантии держите один серверный процесс.

Транспорты

stream — дефолт, потому что он надмножество: тот же поток сообщений, плюс выполняющийся ход остаётся доступным, а прерванный завершается в протоколе, сохраняя хвост потока. Выбирайте на каждый вызов через transport или задайте дефолт через QWEN_MCP_TRANSPORT=print.

Этот сервер никогда ничего не отправляет в qwen по своей инициативе. Ни автоматического завершения перед дедлайном, ни внедрённых инструкций: qwen_send срабатывает только когда вызывающий вызывает его.

Окружение

Дизайн

• Процесс на вызов. Собственные файлы сессий qwen — источник истины, именно поэтому продолжения переживают перезапуск этого сервера.

• Контракт на проводе — собственный протокол stream-json qwen, говорим напрямую — сообщения с разделителями строк в stdout, управляющие запросы и пользовательские ходы в stdin. Его формы заимствованы из @qwen-code/sdk через import type, поэтому изменение в апстриме ломает сборку, а не сервер. Ноль зависимостей во время выполнения.

• Закрытие с ошибкой на всё, что приходит от qwen. Неизвестный подтип результата, неудачное рукопожатие, строка, которая не парсится — сообщается как есть, никогда не нормализуется в успех.

• Ни один процесс не переживает свой запрос. Таймауты, отмены и завершение работы вычищают всё дерево процессов qwen; ничего не остаётся ни на одном пути.

Разработка

TypeScript (нативный tsc), Biome, Vitest. Тесты гоняют реальный бинарник сервера через stdio против фикстуры, говорящей на протоколе qwen; живые тесты против установленного qwen — опциональны.

npm run hooks          # once per clone: git hooks from .githooks/
npm run build          # tsc -> dist/
npm test               # unit + type tests, no API access, no tokens
npm run test:live      # 4 live tests against the real qwen binary (spends tokens)
npm run check          # format + types + tests
npm run fix            # biome --write

Лицензия

MIT