Kiro CLI 2.0 TUI 模式 MCP Server 不加载的解决方案

说明

Kiro CLI 2.0.x 版本的 TUI（终端界面）模式存在一个已知 Bug：MCP server 配置文件被正确读取，但工具列表不出现在对话中，实际上 MCP 并未初始化。

症状

• kiro --tui 模式下，配置的 MCP server 不出现
• 让 Kiro 使用某个 MCP 工具时，报"工具不存在"或找不到 server
• 非 TUI 模式（kiro chat）正常，TUI 模式复现

根因

Kiro CLI 2.0 重写了 TUI 的启动流程，MCP 初始化代码的触发时机与 2.0 之前不一致，导致 TUI 启动时 MCP server 的连接没有在正确的生命周期节点初始化。

此问题在 v2.0.4（2026-01-08）中已修复。

解决方案

方案一：升级到 v2.0.4+（推荐）

# 检查当前版本
kiro --version

# 升级（Windows PowerShell，管理员）
irm https://kiro.dev/install/win | iex

# macOS/Linux
curl -fsSL https://kiro.dev/install/sh | sh

方案二：临时绕过（使用非 TUI 模式）

若无法立即升级，改用非 TUI 的 chat 模式：

kiro chat "帮我查看当前目录结构"

非 TUI 模式不受此 Bug 影响，MCP 工具可以正常调用。

方案三：手动指定配置文件路径

部分用户反映显式传入配置路径可绕过该问题：

kiro --tui --config ~/.kiro/settings.json

验证方法

升级后，在 TUI 界面中输入 /tools，确认 MCP server 的工具列表正常出现。

来源：GitHub Issue #7425，Kiro CLI v2.0.4 Changelog