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

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

Model Context Protocol(MCP)允许通过外部进程扩展模型能力,npx 和 uvx 是两种即装即用的客户端工具。对比了两者原理,提供 Windows、macOS、Linux 下的详细安装、验证及使用示例,涵盖 Node.js 生态的 npm 包执行与 Python 生态的隔离环境运行,助力在本地或 CI/CD 流程中无缝集成 MCP 服务器。

292440837发布于 2026/2/6更新于 2026/7/2452 浏览
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  registry https://registry.npmmirror.com/ 
set

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. 或 pip install uvenv # 安装新版
  12. 4.3 可选:Shell 集成
  13. 5. 安装验证
  14. 示例(macOS/Linux)
  15. 6. 使用示例
  16. 6.1 运行 MCP 服务器
  17. JavaScript 版(通过 npx)
  18. Python 版(通过 uvx/uvenv)
  19. 或 uvenv modelcontextprotocol-server-chat
  20. 6.2 临时执行任意工具
  21. 安装并运行 eslint
  22. 安装并运行 pyflakes
  23. 7. 常见问题
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • Buzz 离线语音转文字工具安装与配置(基于 Whisper)
  • Qwen3-VL 与 LLaMA-Factory 实现 Grounding 任务 LoRA 微调
  • Conceal 加密实战:保护 Android 应用敏感数据
  • Agent Skills 设计详解:构建可复用的 AI 智能体工作流
  • 本地部署 GLM-4.6V-Flash-WEB 保障数据隐私
  • 告别从零开发!AI+AR眼镜开源方案来了|PUSHI G1赋能18个全场景,联动腾讯/阿里云落地
  • 机器人通讯总线选型指南:CAN/FD、高速 485 与 EtherCAT 对比
  • macOS 配置 Git 平台 SSH 连接
  • Windows + WSL + Ubuntu 安装 OpenClaw 及飞书百炼集成指南
  • 在 Android 设备上利用 Termux 安装 llama.cpp 并启动 WebUI
  • AM32 无人机电调源码架构与工作原理解析(上)
  • GoView 低代码数据可视化开发平台使用指南
  • 无人机 RemoteID 合规指南:ArduRemoteID 开源方案详解
  • OpenClaw 集成 GitHub Copilot GPT-5.4 技术修复指南
  • GitHub Copilot 兼容 OpenAI/Anthropic API 代理服务详解
  • Spring AI Agent Skills 接入与原理剖析
  • DBeaver 连接 Kerberos 认证的 Hive 数据库 (Apache/HDP)
  • GitHub 个人访问令牌(PAT)生成及 R 环境配置指南
  • Midjourney 第三方 API 服务技术原理与合规边界探讨
  • 达梦数据库 Java 外部函数配置小记

相关免费在线工具

  • 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