Как установить npx на Windows, macOS и Linux: пошаговая инструкция

Открываете инструкцию к MCP-серверу, а там первой же строкой стоит npx. И почти ни слова о том, откуда его взять и как поставить. Разберёмся, что это за штука, почему на ней держится половина MCP-серверов и как поставить её на Windows, macOS и Linux.

Зачем вообще нужен npx

Большинство MCP-серверов написано на JavaScript и лежит в реестре npm. Чтобы клиент (Claude Desktop, Cursor, VS Code) поднял такой сервер, пакет нужно сперва скачать и запустить. Этим npx и занимается. В конфиге это выглядит так:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/Documents"]
    }
  }
}

Клиент читает конфиг и выполняет npx -y @modelcontextprotocol/server-filesystem .... npx скачивает пакет во временную папку, запускает его и не тянет ничего в глобальные зависимости. Флаг -y тут велит не переспрашивать, а поставить пакет молча, если того ещё нет в кэше. Штука удобная: не надо ставить каждый сервер руками и следить за версиями. Обновился пакет в реестре, и при следующем запуске подтянется свежий.

Так что без npx большинство инструкций по установке MCP-серверов попросту не сработает. Но ставить его отдельно не придётся, и вот почему.

Что такое npx и откуда он берётся

npx это спутник npm, пакетного менеджера Node.js. А npm, в свою очередь, идёт в комплекте с самой Node.js. Цепочка простая: ставите Node.js, вместе с ней получаете npm, а с ним и npx. Отдельного установщика у npx нет, искать его по интернету не нужно.

Отсюда и главное правило: чтобы получить npx, ставим Node.js. Брать лучше LTS-версию (Long Term Support), она стабильнее и её дольше поддерживают. Дальше пройдёмся по установке для каждой системы по очереди.

Установка на Windows

Проще всего через официальный установщик:

1. Зайдите на nodejs.org и скачайте LTS-версию (файл .msi).
2. Запустите установщик и жмите «Next», ничего не трогая. Галочку «Add to PATH» не снимайте, она и так стоит по умолчанию.
3. Дойдите до конца и нажмите «Install».

Любите ставить программы из терминала? Тогда всё сводится к одной команде в PowerShell через пакетный менеджер winget:

winget install OpenJS.NodeJS.LTS

После установки закройте терминал (PowerShell или cmd) и откройте заново, открытые окна про новый PATH ещё не знают. Потом проверьте, что всё встало:

node -v
npx -v

Обе команды должны выдать номер версии. Выдали, значит npx готов к работе.

Установка на macOS

На Mac есть два пути.

Официальный установщик. Скачайте .pkg-файл LTS-версии с nodejs.org, запустите и пройдите установку по шагам. Способ рабочий и ничего сверх этого не требует.

Через Homebrew. Если у вас стоит пакетный менеджер Homebrew, хватит одной команды в терминале:

brew install node

Проверяем результат:

node -v
npx -v

Обе команды показали версию, всё на месте. А если терминал отвечает command not found, закройте его и откройте заново, чтобы подтянулись свежие пути.

Установка на Linux

На Linux вариантов тоже хватает, но удобнее всего nvm (Node Version Manager). Он ставит Node прямо в домашнюю папку, не просит sudo и не дерётся с системными пакетами.

Сначала ставим сам nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Затем закройте и снова откройте терминал (либо выполните source ~/.bashrc) и поставьте LTS-версию Node:

nvm install --lts

nvm сам скачает Node, а заодно npm и npx. Проверяем:

node -v
npx -v

Версии вывелись, готово.

Node можно поставить и через штатный пакетный менеджер дистрибутива (apt, dnf и им подобные), но там частенько лежит устаревшая версия, которую потом неудобно обновлять. Для MCP-серверов с nvm обычно спокойнее.

Проверка и что дальше

Проверка на любой системе одна и та же:

node -v
npx -v

Обе команды отвечают номером версии, значит Node.js и npx на месте, и можно возвращаться к настройке MCP-сервера. Только обязательно полностью перезапустите клиент (Claude Desktop, Cursor, VS Code): не свернуть, а закрыть и открыть заново. Иначе он подтянет старое окружение и npx не увидит.

Клиент не видит npx, хотя он установлен: проблема с PATH

Частая ситуация: в терминале npx -v честно показывает версию, а клиент всё равно падает с npx is not recognized или command not found. Значит, установка тут ни при чём, дело в PATH.

PATH это переменная окружения со списком папок, где система ищет исполняемые файлы. Набрали npx, и система идёт по списку папка за папкой, пока не наткнётся на нужный файл. Терминал при запуске подгружает ваши настройки (.zshrc, .bashrc на macOS и Linux, системный PATH на Windows), и папка с Node туда попадает, поэтому в терминале npx работает. А вот Claude Desktop, Cursor и прочие приложения с графическим интерфейсом стартуют в обход этих настроек, с урезанным PATH, где про вашу папку с Node ничего не сказано. Отсюда и command not found при живом npx в соседнем окне.

Лечится в лоб: не заставляйте клиент искать npx по имени, пропишите в конфиге полный путь до файла. Узнать путь:

which npx          # macOS / Linux
where.exe npx      # Windows

Дальше в конфиге меняете короткое имя на этот путь:

"command": "/usr/local/bin/npx"

На Windows путь будет вида "C:\\Program Files\\nodejs\\npx.cmd". Тут два нюанса: в JSON обратные слэши обязательно удваиваются, а у файла расширение .cmd. После правки снова полностью перезапустите клиент, чтобы он перечитал конфиг.

Если Node ставили через nvm, путь будет меняться после каждого nvm use, и конфиг придётся поправлять заново. Этот и другие частные случаи подробно разобраны в статье Ошибки npx при запуске MCP-сервера.