Claude Code MCP 启动超时：工具加载不出来

30 秒结论

MCP 进程没在规定时间内握手。多数是第一次跑 npx 在下载包。

报错原文对照

MCP server 'xxx' failed to start within 30000ms

原因排序

概率	原因
45%	npx 首次下载依赖太慢
30%	命令路径写错，进程直接退出
25%	服务器启动需要网络但被墙

修法

先在自己这边查

1. 先把 MCP 命令在终端手动跑一遍，看能不能起来
2. 给 MCP 加大启动超时
3. 预装依赖，避免每次 npx 下载

再往服务方查

1. 检查 MCP 配置里的 command 和 args

责任判定表

现象	责任方
手动能跑、Claude 里不行	环境变量不同
两边都不行	MCP 本身的问题
偶尔超时	网络或冷启动

什么时候该换

一直超时就换一个 MCP 实现。