# 部署问题修复：MCP Inspector 模块未找到
**修复时间**：2025-12-05
**影响环境**：开发环境
**错误级别**：Medium
## 问题描述
### 错误信息
```
Error: Cannot find module '/home/lyf/workspaces/web-analysis-mcp/node_modules/@modelcontextprotocol/inspector/dist/cli.js'
at Function._resolveFilename (node:internal/modules/cjs/loader:1383:15)
...
code: 'MODULE_NOT_FOUND'
```
### 环境信息
- 部署环境：开发环境
- 部署方式：VSCode 调试配置
- 错误阶段：启动调试
## 解决方案
### 根本原因
VSCode 的 launch.json 配置中使用了错误的路径。`@modelcontextprotocol/inspector` 是作为全局 npm 包安装的，不在项目的 `node_modules` 目录中，而配置文件错误地尝试使用本地路径。
### 修改文件
- `.vscode/launch.json`：修复 MCP Inspector 调试配置中的路径问题
### 修改详情
**修改前**：
```json
{
"program": "${workspaceFolder}/node_modules/@modelcontextprotocol/inspector/dist/cli.js",
"args": [
"--config",
"${workspaceFolder}/.mcp-inspector.dev.json",
"--mcp",
"node ${workspaceFolder}/node_modules/tsx/dist/cli.js ${workspaceFolder}/src/index.ts"
]
}
```
**修改后**：
```json
{
"program": "mcp-inspector",
"args": [
"--config",
"${workspaceFolder}/.mcp-inspector.dev.json",
"--mcp",
"npx tsx ${workspaceFolder}/src/index.ts"
],
"envFile": "${workspaceFolder}/.env"
}
```
## 验证结果
- [x] mcp-inspector 命令可以正常运行
- [x] VSCode 调试配置已更新
- [x] 调试环境加载环境变量配置
## 预防措施
1. 在配置 VSCode 调试时，使用命令名而非绝对路径，除非确定该包是本地安装
2. 对于全局安装的 npm 包，直接使用命令名称，让 Node.js 通过 PATH 查找
3. 在调试配置中始终包含环境变量文件，确保调试环境与运行环境一致
