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 <包名>。
愿你我都能在各自的领域里不断成长,勇敢追求梦想,同时也保持对世界的好奇与善意!