# 错误修复：MCP Inspector 配置文件格式错误
**修复时间**：2025-12-04
**错误级别**：Medium
## 问题详情
### 错误信息
```
> web-analysis-mcp@0.1.0 test:inspector
> mcp-inspector --config .mcp-inspector.json
No servers found in config file
```
### 错误类型
- 类型：配置
- 状态码：配置解析失败
## 解决方案
### 根本原因
1. MCP Inspector 配置文件使用了错误的键名 `servers`，应该是 `mcpServers`
2. 使用 `npm run dev` 命令会产生额外的输出，干扰 MCP 协议通信
### 修改文件
- `.mcp-inspector.json`：修复配置格式
- `test-server.js`：创建包装脚本避免 npm 输出干扰
### 代码变更
```json
// 修改前
{
"servers": {
"web-analysis": {
"command": "npm",
"args": ["run", "dev"]
}
}
}
// 修改后
{
"mcpServers": {
"web-analysis": {
"command": "node",
"args": ["test-server.js"]
}
}
}
```
```javascript
// 新增文件：test-server.js
#!/usr/bin/env node
import { spawn } from 'child_process';
const child = spawn('npx', ['tsx', 'src/index.ts'], {
stdio: 'inherit',
env: process.env
});
```
## 验证结果
- [x] 配置文件格式正确
- [x] MCP Inspector 能够识别服务器
- [x] 避免了 npm 输出干扰
## 注意事项
使用 MCP Inspector 时需要确保：
1. 配置文件使用 `mcpServers` 而不是 `servers`
2. 避免使用会产生额外输出的命令（如 npm scripts）
3. 直接使用 node 或编译后的文件运行 MCP 服务器
