Kiro CLI MCP 工具按需加载（Tool Search）

说明

Kiro CLI 从 v1.8（2025-12-10）起引入 Tool Search 机制，解决 MCP 工具数量过多时上下文膨胀的问题。

问题背景

当配置了大量 MCP server 时（例如 20+ 个工具），Kiro 会把所有工具描述一次性注入提示词，导致：

• Token 用量显著增加
• 响应延迟变长
• 部分模型上下文窗口溢出

解决方案：Tool Search（按需加载）

Tool Search 允许 Kiro 只在需要时动态查找并加载对应的 MCP 工具，而不是提前注入全部工具描述。

开启方法

在 .kiro/settings.json 中：

{
  "mcpToolSearch": {
    "enabled": true,
    "threshold": 0.6
  }
}

或者通过 CLI 参数：

kiro --enable-tool-search

参数说明

参数	类型	默认值	说明
enabled	boolean	false	是否开启按需加载
threshold	number	0.6	语义相似度阈值（0~1），越高越严格

适用场景

• 配置了 10 个以上 MCP server 的工作区
• 需要控制 Token 成本的场景
• 经常遇到"上下文超出限制"错误

注意事项

Tool Search 依赖 Kiro 内置的嵌入模型对工具描述进行语义检索。如果工具描述不清晰，可能导致 Kiro 找不到正确的工具。

建议：为每个 MCP server 的工具写清晰的 description 字段，明确工具的功能和使用场景。

官方文档：kiro.dev/docs/mcp/#tool-search

来源：GitHub Issue #6808