MiMoCode 配置 “Unrecognized key: mcpServers“ 问题解决方案

问题描述

在使用 MiMoCode（小米推出的 AI 编程助手）时，尝试在配置文件 mimocode.json 中添加 MCP 服务器配置后，启动 MiMoCode 报错：

Configuration is invalid at C:\Users\ziyitty\.config\mimocode\mimocode.json
↳ Unrecognized key: "mcpServers"

问题原因

MiMoCode 的配置格式与 Claude Desktop 等其他 AI 工具不兼容。主要区别在于：

配置项	Claude Desktop 格式	MiMoCode 格式
MCP 服务器键名	mcpServers	mcp
服务器定义格式	对象（Object）	数组（Array）
启动命令格式	command + args	command 数组

Claude Desktop 格式（❌ 错误）

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp"]
    }
  }
}

MiMoCode 格式（✅ 正确）

{
  "mcp": {
    "chromedevtools": {
      "type": "local",
      "command": ["cmd", "/c", "npx", "-y", "chrome-devtools-mcp@latest"],
      "enabled": true,
      "timeout": 20000
    }
  }
}

解决方案

1. 配置文件位置

MiMoCode 支持两个级别的配置：

• 全局配置 ：%USERPROFILE%\.config\mimocode\mimocode.json
• 项目级配置 ：<项目目录>\.mimocode\mimocode.json

推荐使用项目级配置，避免全局配置污染其他项目。

2. 完整配置示例

以下配置适用于 Chrome DevTools MCP 服务器：

{
  "$schema": "https://mimo.xiaomi.com//config.json",

  // 设置默认使用的 agent
  "default_agent": "build",

  // MCP 服务器配置
  "mcp": {
    "chromedevtools": {
      "type": "local",
      "command": [
        "cmd", "/c", "npx", "-y", "chrome-devtools-mcp@latest"
      ],
      "enabled": true,
      "timeout": 20000
    }
  },

  // 全局权限配置
  "permission": {
    "*": "ask",
    "bash": "allow",
    "edit": "allow",
    "webfetch": "allow",
    "chromedevtools_*": "allow"
  },

  // 全局工具白名单
  "tools": {
    "chromedevtools_*": true
  },

  // Agent 配置
  "agent": {
    "build": {
      "mode": "primary",
      "tools": {
        "chromedevtools_*": true,
        "bash": true,
        "read": true,
        "edit": true,
        "write": true,
        "grep": true,
        "glob": true,
        "webfetch": true,
        "websearch": true,
        "skill": true
      },
      "permission": {
        "chromedevtools_*": "allow",
        "bash": "allow",
        "edit": "allow",
        "webfetch": "allow"
      }
    }
  }
}

3. 关键配置说明

MCP 服务器名称

使用 chromedevtools 而不是 chrome-devtools，这样工具前缀更稳定：

• ✅ chromedevtools_navigate_page
• ❌ chrome-devtools_navigate_page

Windows 启动命令

在 Windows 上，使用 cmd /c npx 启动 MCP 服务器，避免子进程启动失败：

"command": ["cmd", "/c", "npx", "-y", "chrome-devtools-mcp@latest"]

超时设置

MCP 服务器首次启动可能较慢，建议设置 20 秒超时：

"timeout": 20000

工具白名单

必须在 agent.tools 和全局 tools 中启用 MCP 工具：

"tools": {
  "chromedevtools_*": true
}

权限配置

必须为 MCP 工具设置权限为 allow：

"permission": {
  "chromedevtools_*": "allow"
}

4. 验证配置

重启 MiMoCode 后，在对话中输入：

列出你当前可用的所有工具名称。重点检查是否有 chromedevtools_* 工具。

5. 常见 MCP 工具名称

Chrome DevTools MCP 注入成功后，工具名称格式为：

工具名	功能
chromedevtools_list_pages	列出所有页面
chromedevtools_navigate_page	导航到指定页面
chromedevtools_new_page	打开新页面
chromedevtools_take_screenshot	截图
chromedevtools_take_snapshot	获取页面快照
chromedevtools_evaluate_script	执行 JavaScript
chromedevtools_list_console_messages	获取控制台日志
chromedevtools_list_network_requests	获取网络请求

备选方案：CLI 方式

如果 MCP 注入仍有问题，可以通过 CLI 方式使用 Chrome DevTools：

安装

npm i -g chrome-devtools-mcp@latest

常用命令

# 检查状态
chrome-devtools status

# 打开页面
chrome-devtools new_page "http://localhost:3000"

# 列出页面
chrome-devtools list_pages --output-format=json

# 截图
chrome-devtools take_screenshot --filePath screenshot.png

# 获取控制台日志
chrome-devtools list_console_messages --output-format=json

排查清单

优先级	排查点	处理方式
1	配置键名错误	mcp 而不是 mcpServers
2	Agent 不是 build	设置 "default_agent": "build"
3	工具白名单未包含 MCP	添加 "chromedevtools_*": true
4	Windows 启动命令错误	使用 ["cmd", "/c", "npx", "-y", "..."]
5	MCP 启动超时	添加 "timeout": 20000
6	会话未重建	完全退出后重新启动

参考资料

• MiMoCode 官方文档 - MCP Servers
• MiMoCode GitHub 仓库
• Chrome DevTools MCP 官方文档