npx 与 npm 全局安装/更新/卸载

npx 与 npm 全局安装/更新/卸载:以 MCP Inspector 和 DeepSeek Harness 为例

在日常开发中,我们经常需要运行一些 Node.js 命令行工具。npx 和 npm install -g 是两种最常见的用法,但它们适用的场景不同。本文将以 MCP Inspector 和 DeepSeek Harness 为例,总结如何通过 npx 运行,以及如何全局安装、更新和卸载。


一、npx:免安装的快速运行方式

npx 是 npm 自带的包执行器。它会临时下载并运行包,不会污染全局环境,适合快速测试或偶尔使用,为最新版本。

MCP Inspector 示例

MCP Inspector 官方推荐使用 npx 运行:

bash 复制代码
npx @modelcontextprotocol/inspector node path/to/server/index.js

如果需要 CLI 模式:

bash 复制代码
npx @modelcontextprotocol/inspector --cli node path/to/server/index.js --method tools/list

Deepseek Harness

bash 复制代码
npx @deepseek-ai/dsh web

优点:

  • 无需安装,始终使用最新版。
  • 不占用全局磁盘空间。
  • 适合 CI/CD 或一次性调试。

注意:Node.js 版本需满足要求(MCP Inspector 要求 Node.js >= 22.19.0)。

二、npm 全局安装:高频使用的选择

如果你需要频繁使用某个工具,全局安装会更方便:命令更短,启动更快,且无需每次联网下载。

1. MCP Inspector 全局安装

bash 复制代码
npm install -g @modelcontextprotocol/inspector

安装后可直接使用 mcp-inspector 命令:

bash 复制代码
mcp-inspector node path/to/server/index.js

CLI 模式:

bash 复制代码
mcp-inspector --cli node path/to/server/index.js --method tools/list

2. DeepSeek Harness 全局安装

DeepSeek Harness 的包名为 @deepseek-ai/dsh,命令为 dsh:

bash 复制代码
npm install -g @deepseek-ai/dsh

安装后即可使用:

bash 复制代码
dsh --version

三、更新全局包

全局包不会自动更新,需要手动执行 npm 命令。

通用更新命令

bash 复制代码
npm update -g <包名>

或指定最新版:

bash 复制代码
npm install -g <包名>@latest

MCP Inspector 更新

bash 复制代码
npm update -g @modelcontextprotocol/inspector

或:

bash 复制代码
npm install -g @modelcontextprotocol/inspector@latest

DeepSeek Harness 更新

bash 复制代码
npm update -g @deepseek-ai/dsh

或:

bash 复制代码
npm install -g @deepseek-ai/dsh@latest

验证更新结果

bash 复制代码
# 查看当前版本
dsh --version
mcp-inspector --version

# 查看 npm 上的最新版本
npm view @deepseek-ai/dsh version
npm view @modelcontextprotocol/inspector version

更新排错

  • 权限错误 (EACCES) :macOS/Linux 可加 sudo,Windows 以管理员身份运行终端。
  • 缓存问题:如果版本未变化,尝试清理缓存:
bash 复制代码
npm cache clean --force

然后重新执行更新命令。

注意 :更新 DeepSeek Harness 本体不会自动更新已安装的插件。插件需要在插件市场单独更新,或重新安装。可以安装 dsh-updater 插件实现一键更新:

bash 复制代码
dsh plugin --profile web add @wizzy-1547/dsh-updater@latest

四、卸载全局包

如果不再需要某个全局工具,可以将其卸载。

MCP Inspector 卸载

bash 复制代码
npm uninstall -g @modelcontextprotocol/inspector

DeepSeek Harness 卸载

bash 复制代码
npm uninstall -g @deepseek-ai/dsh

卸载后,对应的全局命令(mcp-inspector、dsh)将不再可用。

五、npx vs 全局安装:如何选择?

对比项 npx npm 全局安装
安装方式 无需安装,临时下载 永久安装
命令长度 较长,需带包名 短,直接使用命令
版本 默认最新,可指定 固定,需手动更新
适用场景 快速测试、偶尔使用、CI 高频使用、日常开发
磁盘占用 几乎不占 占用全局 node_modules
更新 每次运行自动拉取 需手动 npm update -g

建议:

  • 初次体验或临时调试 → 用 npx。
  • 每天都要用 → 全局安装。
  • 需要固定版本 → 全局安装并锁定版本。

六、总结

本文以 MCP Inspector 和 DeepSeek Harness 为例,梳理了 Node.js 命令行工具的三种核心操作:

  • npx 运行:免安装,适合快速测试。
  • 全局安装 :npm install -g <包名>,适合高频使用。
  • 更新 :npm update -g <包名> 或 npm install -g <包名>@latest。
  • 卸载 :npm uninstall -g <包名>。

愿你我都能在各自的领域里不断成长,勇敢追求梦想,同时也保持对世界的好奇与善意!

相关推荐
用户029537195052 天前
给 AI 编程助手造一个本地凭据库:MCP 工具设计、密钥注入和输出打码的工程细节
mcp
jerrywus2 天前
chrome-devtools-mcp 总弹授权、抢标签页?我是这样一步步配好的
前端·agent·mcp
大连好光景2 天前
Claude Code Agent SDK详解
lsp·hooks·mcp·claudecode·skills·mcp命名规范与调用权限
小易老师AI实战2 天前
MCP服务快速实现智能体/RAG项目的插拔功能
agent·rag·mcp·fastmcp·大模型工具调用·streamable‑http
Maiko Star2 天前
*【HM-LC】LangChain MCP详解:核心概念、外部服务连接与自定义服务
langchain·mcp
古雨蓝枫2 天前
DeepSeek Harness(DSH)使用指南:功能、自定义模型与插件
ai·ai编程·deepseek·dsh
古雨蓝枫2 天前
DeepSeek Harness 插件开发进阶:从 Host 工具到 Client UI
ai·ai编程·deepseek·dsh
MasonYyp2 天前
安装npm依赖仓库Verdaccio
前端·npm·node.js
vjmap2 天前
WebGIS + AI 智能体:唯杰地图智能体平台一句话处理 CAD 图纸,支持 MCP 接入 AI 编辑器
gis·agent·mcp
jiangliushi63 天前
GPT-6.1 Sol 免费用:PowerShell 装 Codex 报“禁止运行脚本 npm.ps1”?一条命令解决
前端·gpt·npm