在现代 AI 开发中,Model Context Protocol(MCP)允许通过外部进程扩展模型能力,而 npx(Node.js 生态)和 uvx(Python 生态)则是两种即装即用的客户端工具,帮助你快速下载并运行 MCP 服务器或工具包,无需全局安装。本文将从原理和对比入手,提供面向 Windows、macOS、Linux 的详细安装、验证及使用示例,确保你能在本地或 CI/CD 流程中无缝集成 MCP 服务器。
1. 工具简介
1.1 npx(Node.js/npm)
npx 是 npm CLI(≥v5.2.0)自带的命令,可在不全局安装的情况下,临时下载并执行 npm 包中的可执行文件。例如:
npx @modelcontextprotocol/server-example
会下载并运行 @modelcontextprotocol/server-example 包,而不会在系统中留下全局依赖。该功能简化了快速试用和 CI 环境中一次性命令的执行流程。
1.2 uvx(Python/pipx 或 pip)
uvx 最初是 uv 项目的别名,用于在隔离环境中临时安装并运行 Python 包提供的命令行工具,类似于 pipx run。例如:
uvx pycowsay 'hello world!'
会在数十毫秒内下载并执行 pycowsay,命令结束后环境可选保留或销毁,大幅减少依赖管理开销。
2. 安装前准备
- 网络访问:确保能访问 npm registry(registry.npmjs.org)和 PyPI(pypi.org)。
- 权限:在 Windows 下使用 PowerShell(管理员身份)或启用执行策略
RemoteSigned。 - 已有环境:
- Node.js ≥v16(包含 npm 和 npx)
- Python ≥3.10(支持
pipx或pip安装)
3. 安装 npx
3.1 安装 Node.js
- 下载 LTS 安装包 前往 Node.js 官网 下载并安装 LTS 版(推荐 v18 或更高)。
验证安装
node --version # 应输出 v16+
npm --version # 应输出 v7+
npx --version # 应输出 v7+,npm ≥5.2.0 即自带 npx
若缺少 npx,可手动安装:
npm install -g npx
3.2 全局配置(可选)
- 增加命令白名单(在某些 IDE/CI 中需要)
在 MCP 客户端配置文件(如 Chainlit 的
config.toml)中,将npx加入allowed_executables列表。
更换镜像源(国内用户常用)
npm config set registry https://registry.npmmirror.com/


