MCP 工具速成：npx 与 uvx 全流程安装指南

在现代 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 包，而不会在系统中留下全局依赖。

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 列表。

更换镜像源（国内用户常用）