当运行 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 相关进程：
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
⚠️ 注意事项：
- 不要忽略
sudo权限：lsof查看所有用户进程需 root 权限，否则可能漏检系统级占用； - 避免频繁硬杀进程：长期出现此问题，建议检查是否重复执行
mcp dev server.py未关闭前序实例； - 浏览器缓存干扰：首次修复后，建议无痕模式访问
http://127.0.0.1:6274，排除 Service Worker 缓存影响； - macOS 用户注意：若仍失败，可临时关闭“防火墙”或检查
pfctl规则是否拦截本地回环流量。
完成上述操作后，刷新 MCP Inspector 页面，正常应显示服务拓扑、模型调用日志及实时 trace 数据——这标志着代理链路已完全贯通。
