如何解决 MCP Inspector Proxy 连接失败问题-Python教程-PHP中文网

如何解决 MCP Inspector Proxy 连接失败问题

当运行 mcp dev server.py 启动 MCP 开发服务器后，控制台显示 Inspector 已启动（如 http://127.0.0.1:6274），但浏览器无法访问，通常是因为代理端口 6277 被占用导致连接中断。

当运行 `mcp dev server.py` 启动 mcp 开发服务器后，控制台显示 inspector 已启动（如 http://127.0.0.1:6274），但浏览器无法访问，通常是因为代理端口 6277 被占用导致连接中断。

MCP Inspector 依赖一个本地代理服务（默认监听端口 6277）来桥接前端界面与后端服务。即使控制台显示 “Proxy server listening on port 6277”，该提示仅表示进程尝试绑定成功——实际端口可能已被其他程序抢占，或旧进程残留导致绑定失败但未报错。此时 Inspector 页面虽能加载，却无法建立 WebSocket 或 HTTP 代理通道，表现为白屏、加载中卡死或 Network 面板中 /api/... 请求 503/ERR_CONNECTION_REFUSED。

✅ 快速诊断与修复步骤如下：

确认端口 6277 是否真实就绪
执行命令检查端口占用情况：
```
sudo lsof -i :6277
```
若输出非空（例如显示 node、python 或 mcp 进程），说明端口已被占用；若无输出，则可能是 MCP 进程异常退出后端口未释放，或防火墙/权限拦截。
终止干扰进程
根据上一步输出中的 PID（如 623862），强制结束：
```
kill -9 623862
```
同时清理可能残留的 MCP 相关进程：

Nginx Reverse Proxy
配置 Nginx 反向代理，实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发，将域名绑定到指定 IP:端口。

下载
```
ps aux | grep mcp | grep -v grep | awk '{print $2}' | xargs kill -9 2>/dev/null || true
```
重启服务并预留缓冲时间
端口释放后需短暂等待内核完成 TIME_WAIT 回收，建议加 sleep 2：
```
sleep 2
mcp dev server.py
```