MCP 工具调用总是超时，是我的配置有问题还是模型本身的理解能力不够？

我也踩过这个坑，大概率不是模型理解力的问题。你试试把工具数量先砍到两三个，MCP server 注册太多 tool 的时候模型很容易犯选择困难，反复调同一个往往是它在试探。参数对不上多半是 schema 里嵌套对象或 enum 的写法跟模型预期有偏差，建议把 required 字段减到最少。超时的话看看是不是 server 端有阻塞操作，MCP 是同步等待的，工具里跑个耗时任务直接就卡死了。

工具描述太长反而容易让模型犯迷糊，试试精简下再补个few-shot示例？

工具描述越详细模型越容易纠结，试着精简下描述、加个调用次数上限，超时多半是死循环了。

我之前也踩过这个坑，后来发现大概率不是模型理解力的问题，而是工具描述太“全”反而容易让模型犹豫。你可以试试把每个tool的description写得更短更聚焦，重点说清楚“什么时候该用它”，而不是只列功能。另外Claude桌面端对MCP的调用有超时限制，如果server响应慢也会被误判成模型问题，建议先看日志确认是哪一层卡住。

超时大概率是模型反复试错卡住了，工具描述别写太长，精简+加few-shot示例比啥都管用。

工具描述太长了模型反而容易懵，精简下试试，schema 里参数别堆太多。