BUG-0542project-12中已修复deploy-config

MCP Server 是 Trae session 启动时挂载的静态工具列表 —— session 中途启动后端 API 无法让 MCP 自动挂载

发现：2026-10-07验证：2026-10-27置信度：80%

症状

project-14 项目 session 里 AI 发现 dbug-wiki 工具不在可用列表 → AI 手动 uvicorn 启动后端 → curl 验证 API 通 → 但 session 内工具列表不变，MCP 仍不可用 → 必须重启 Trae session 才能挂上

根因

Trae 在 session 启动时一次性解析 mcp.json 并 spawn MCP server 进程；若此时后端 API 未运行，MCP server 启动失败被跳过；后续即使后端起来了，session 内已加载的工具列表是静态快照不会热加载

修复方案

① session 启动前预检脚本（scripts/preflight-mcp.ps1）检查后端 API + MCP server 依赖是否就绪；② mcp.json 配置后显式刷新 MCP 面板（右上角 🔄 按钮）而非等 session 重启；③ 原则：MCP 依赖的外部服务（后端 API/数据库）必须在 session 启动前就运行，不能期望中途启动能热挂载

错误签名

mcp.json 配置正确但 session 内无 dbug-wiki 工具可用，check_bug_exists/report_bug_knowledge 不在 <mcp_file_system> 列表

技术信息

来源项目

project-12

涉及文件

scripts/preflight-mcp.ps1, .trae/mcp.json

标签

project-12, mcp-reported, source-agent