跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言Node.jsAI

MCP 客户端工具 npx 与 uvx 安装使用指南

综述由AI生成Model Context Protocol(MCP)开发中常用的两个即时执行工具 npx 和 uvx。npx 基于 Node.js 生态,用于临时下载运行 npm 包;uvx 基于 Python 生态,类似 pipx 用于隔离环境运行 Python 命令行工具。文章详细说明了 Windows、macOS、Linux 下的环境准备、安装步骤、验证方法及实际运行示例,帮助开发者在本地或 CI/CD 流程中快速集成 MCP 服务器。

性能调优发布于 2026/2/5更新于 2026/5/255.8K 浏览
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 包,而不会在系统中留下全局依赖。该功能简化了快速试用和 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
  1. 下载 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/

4. 安装 uvx / uvenv

4.1 使用 pipx(推荐)

迁移环境 若已安装旧版,执行:

uvenv self migrate

将原 uvx 环境和命令一键移至 uvenv。

安装 uvx(或 uvenv)

pipx install uvx # 安装旧版别名
pipx install uvenv # 安装新版迁移工具

安装 pipx

python3 -m pip install --user pipx
python3 -m pipx ensurepath
4.2 使用 pip(简易)
pip install uvx # 安装旧版(仅 Python x86_64/aarch64 支持 v2.0)
pip install uvenv # 安装新版

注意:uvx v2.0 仅在 Linux x86_64/aarch64 平台通过 PyPI 发布,其它平台请留用 1.x 或源码编译。

4.3 可选:Shell 集成
uvx setup # 为 Bash/Zsh 自动添加命令补全及环境变量

(同理适用于 uvenv)。

5. 安装验证

工具验证命令预期输出
npxnpx --version版本号 ≥7.0.0
uvxuvx --version版本号(显示 v<1.x 或提示已迁移至 uvenv)
uvenvuvenv --version版本号 ≥3.0
# 示例(macOS/Linux)
$ npx --version 8.19.2
$ uvx --version 1.0.2
$ uvenv --version 3.1.0

6. 使用示例

6.1 运行 MCP 服务器
# JavaScript 版(通过 npx)
npx @modelcontextprotocol/server-chat

# Python 版(通过 uvx/uvenv)
uvx modelcontextprotocol-server-chat
# 或
uvenv modelcontextprotocol-server-chat

两者将在本地启动一个 MCP 服务器进程,监听标准 I/O,用于与客户端(如 VS Code Copilot Agent、Chainlit)通信。

6.2 临时执行任意工具
# 安装并运行 eslint
npx eslint .

# 安装并运行 pyflakes
uvx pyflakes your_script.py

7. 常见问题

  • 命令未找到:确认对应工具已加入 PATH,重启终端或手动设置环境变量。
  • 依赖冲突:使用 pipx 可实现完全隔离,避免全局包干扰。
  • 性能考量:uv/uvenv 在多包批量安装场景下比 pipx 更快,但功能侧重点不同,可根据需求选用 (GitHub)。

通过以上步骤,你已掌握在各平台上安装、验证并使用 npx 与 uvx/uvenv 的全流程,助力在 MCP 框架下快速集成和扩展 AI 模型的功能。

目录

  1. 1. 工具简介
  2. 1.1 npx(Node.js/npm)
  3. 1.2 uvx(Python/pipx 或 pip)
  4. 2. 安装前准备
  5. 3. 安装 npx
  6. 3.1 安装 Node.js
  7. 3.2 全局配置(可选)
  8. 4. 安装 uvx / uvenv
  9. 4.1 使用 pipx(推荐)
  10. 4.2 使用 pip(简易)
  11. 4.3 可选:Shell 集成
  12. 5. 安装验证
  13. 示例(macOS/Linux)
  14. 6. 使用示例
  15. 6.1 运行 MCP 服务器
  16. JavaScript 版(通过 npx)
  17. Python 版(通过 uvx/uvenv)
  18. 或
  19. 6.2 临时执行任意工具
  20. 安装并运行 eslint
  21. 安装并运行 pyflakes
  22. 7. 常见问题
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • MySQL 性能优化实战:索引、查询与架构建议
  • Java 反射机制详解:从原理到实战
  • Linux 文件系统详解:从硬件结构到 inode 机制
  • Python 数据统计实战指南
  • Java 包装类详解:基本类型与引用类型的桥梁
  • DJI Cloud API 无人机云平台集成开发指南
  • AIGC 情感化智能客服实战:降低投诉率的技术方案
  • 自然语言处理(NLP)高级应用与前沿技术实战
  • AI 绘画与摄影:ChatGPT、Midjourney 与文心一格工具解析
  • 纪念钞预约实战指南:网络优化与流程准备
  • 绿联 NAS 配置 WebDAV 公网访问并使用 RaiDrive 挂载到本地
  • 利用 KSWEB 在安卓手机部署 Typecho 博客及内网穿透方案
  • 全排列与回溯算法详解:LeetCode 经典题目解析
  • 数据结构实战:链表经典面试题解析
  • OpenClaw 部署与飞书机器人接入实战指南
  • 前端请求后端 404/405/500 状态码排查与解决指南
  • C 语言常用算法与数据结构基础
  • Mac鼠标滚轮救星:Mos让外接鼠标重获新生
  • Agent Skills:构建可扩展 AI 代理能力的模块化架构
  • 前端埋点实现方式与核心原理详解

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online