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

MCP 工具实战:npx 与 uvx 跨平台安装指南

综述由AI生成Model Context Protocol 扩展了 AI 模型能力,npx 和 uvx 提供了无需全局安装的即用型客户端方案。在 Windows、macOS 及 Linux 环境下如何安装验证这两个工具,涵盖 Node.js 与 Python 生态的配置差异、镜像源切换及常见问题排查,帮助开发者在本地或 CI/CD 流程中无缝集成 MCP 服务器。

怪力乱神发布于 2026/2/28更新于 2026/5/2813 浏览
MCP 工具实战:npx 与 uvx 跨平台安装指南

在现代 AI 开发中,Model Context Protocol(MCP)允许通过外部进程扩展模型能力。npx(Node.js 生态)和 uvx(Python 生态)则是两种即装即用的客户端工具,能帮你快速下载并运行 MCP 服务器或工具包,无需全局安装。

工具简介

npx(Node.js/npm)

npx 是 npm CLI(≥v5.2.0)自带的命令,可在不全局安装的情况下,临时下载并执行 npm 包中的可执行文件。例如运行以下命令会直接下载并执行 @modelcontextprotocol/server-example 包,而不会在系统中留下全局依赖:

npx @modelcontextprotocol/server-example

这简化了快速试用和 CI 环境中一次性命令的执行流程。

uvx(Python/pipx 或 pip)

uvx 最初是 uv 项目的别名,用于在隔离环境中临时安装并运行 Python 包提供的命令行工具,类似于 pipx run。例如:

uvx pycowsay 'hello world!'

它会在数十毫秒内下载并执行 pycowsay,命令结束后环境可选保留或销毁,大幅减少依赖管理开销。

安装前准备

  • 网络访问:确保能访问 npm registry(registry.npmjs.org)和 PyPI(pypi.org)。
  • 权限:在 Windows 下使用 PowerShell(管理员身份)或启用执行策略 RemoteSigned。
  • 已有环境:
    • Node.js ≥v16(包含 npm 和 npx)
    • Python ≥3.10(支持 pipx 或 pip 安装)

安装 npx

安装 Node.js

前往 Node.js 官网下载并安装 LTS 版(推荐 v18 或更高)。

验证安装

node --version # 应输出 v16+
npm --version # 应输出 v7+
npx --version # 应输出 v7+,npm ≥5.2.0 即自带 npx

若缺少 npx,可手动安装:

npm install -g npx

全局配置(可选)

  • 增加命令白名单(在某些 IDE/CI 中需要):在 MCP 客户端配置文件(如 Chainlit 的 config.toml)中,将 npx 加入 allowed_executables 列表。
  • 更换镜像源(国内用户常用):
npm config set registry https://registry.npmmirror.com/

安装 uvx / uvenv

使用 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

使用 pip(简易)

pip install uvx # 安装旧版(仅 Python x86_64/aarch64 支持 v2.0)
# 或
pip install uvenv # 安装新版

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

可选:Shell 集成

uvx setup # 为 Bash/Zsh 自动添加命令补全及环境变量

(同理适用于 uvenv)。

安装验证

工具验证命令预期输出
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

使用示例

运行 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)通信。

临时执行任意工具

# 安装并运行 eslint
npx eslint .

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

常见问题

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

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

目录

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

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

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

更多推荐文章

查看全部
  • 使用 Ollama 本地部署 Llama 3.1 大模型指南
  • 大模型技术详解:定义、架构与应用
  • 思维链(CoT)原理探究:基于实证研究的元素分析
  • uni-app 前端 ThinkPHP 后端图库项目源码搭建教程
  • YOLO+OpenClaw+SAM 微调实战:工业缺陷自动标注方案
  • AI 领域必读精选:6 部名家名作
  • 6 个经典 Python 项目实战指南:爬虫、AI、数据分析、Web、办公与游戏
  • 大模型的基石:Transformer 架构深度解析
  • OpenClaw Secure DM Pairing:为 AI 机器人构建安全私信访问机制
  • 基于 Java 的消息队列选型总结:RabbitMQ、RocketMQ、Kafka 实战对比
  • DeepSeek-R1 发布 72 小时:AI 行业主要反响与影响
  • Ollama 底层原理:llama.cpp 与 GGUF 格式解析
  • 使用 LLM 将白雪公主故事转换为 Neo4j 图数据
  • 大模型入门学习教程:从基础到工程化实践
  • TarsosDSP Java 实时音频处理框架技术详解
  • Python 实战:基于 Pygame 的微信风格生日祝福程序
  • LLM 大模型学习路线图详解与技术指南
  • 赋予大型语言模型多模态能力的方法与架构解析
  • VSCode Copilot 登录失败的 9 大常见问题与解决方案
  • 基于 Hugging Face 与 TRL 微调大语言模型实战

相关免费在线工具

  • 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