MCP 配置导入

旧版 WinCode 把 MCP 服务器的配置以 JSON 形式存放在项目的 .claude/settings.json 或全局配置文件里。新版改为在 SQLite 数据库中统一管理 MCP 服务器。legacySync 模块在迁移时,会把旧版的 JSON 配置解析出来,逐条写入新版的 MCP 表。

数据格式差异

旧版的 MCP 配置形如:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"],
      "env": { "SOME_KEY": "xxx" }
    }
  }
}

新版在数据库中为每个 MCP 服务器维护一条记录,字段包括 name、command、args(JSON 数组)、env(JSON 对象)、enabled 等。

迁移策略

legacySyncApply 对 MCP 配置采用合并策略:

• 新增:旧版有、新版没有的服务器,直接插入。
• 跳过:新旧都有同名服务器的,默认保留新版配置,不覆盖。这样可以避免迁移过程中把旧版的参数覆盖到已经调通的配置上。
• 失败:如果旧版 JSON 格式损坏,对应条目会记录到 LegacySyncApplyResult.mcpServers.failed 与 errors 字段,不影响其他类别的迁移。

迁移完成后,对话框会展示 imported / merged / skipped / failed 四个统计,便于核对。

后续维护

导入后,所有 MCP 服务器都在新版设置页的"MCP 管理"面板中统一管理。可以单独启用/禁用、编辑、删除,而不再需要手动编辑 JSON 文件。

相关文档

• 旧版迁移概览
• 会话历史导入