Add managed chrome-devtools MCP for all agents

Author: ly

README.md

@@ -19,6 +19,8 @@
    └────────────────┴──────────────────────────────────┴──────────┴─────────────┘
 ```
 
+默认受管 MCP 服务器当前包含 `augment-context-engine`（代码库检索）和 `chrome-devtools`（浏览器调试 / network / performance，使用官方推荐的 `npx -y chrome-devtools-mcp@latest`）。
+
 ## Agent 安装源依据 (Official Evidence)
 
 本项目的生命周期管理逻辑严格对齐以下官方发布渠道：

config/manager.json

@@ -26,7 +26,8 @@
     "ui-ux-pro-max-skill": { "enabled": true }
   },
   "mcp": {
-    "augment-context-engine": { "enabled": true }
+    "augment-context-engine": { "enabled": true },
+    "chrome-devtools": { "enabled": true }
   },
   "terminal": {
     "enabled": false

config/mcp.json

@@ -7,6 +7,12 @@
         "AUGMENT_SESSION_AUTH": "${AUGMENT_SESSION_AUTH}"
       },
       "agents": null
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"],
+      "env": {},
+      "agents": null
     }
   },
   "agent_paths": {

docs/MCP-CONFIG-GUIDE.md

@@ -8,9 +8,11 @@
 
 1. [快速开始](#快速开始)
 2. [各 Agent 的 MCP 配置格式](#各-agent-的-mcp-配置格式)
-3. [augment-context-engine 专项说明](#augment-context-engine-专项说明)
-4. [常见问题与解决方案](#常见问题与解决方案)
-5. [调试技巧](#调试技巧)
+3. [当前仓库默认受管 MCP 服务器](#当前仓库默认受管-mcp-服务器)
+4. [augment-context-engine 专项说明](#augment-context-engine-专项说明)
+5. [chrome-devtools 专项说明](#chrome-devtools-专项说明)
+6. [常见问题与解决方案](#常见问题与解决方案)
+7. [调试技巧](#调试技巧)
 
 ---
 
@@ -37,6 +39,20 @@ cd agent-mcp && python3 sync_mcp.py --config ../config/manager.json --def-file .
 
 ---
 
+## 当前仓库默认受管 MCP 服务器
+
+| Server | 用途 | 受管命令 | 凭证 | 默认策略 |
+|--------|------|----------|------|----------|
+| `augment-context-engine` | 代码库检索、语义搜索、codebase-retrieval | `auggie --mcp --mcp-auto-workspace` | `AUGMENT_SESSION_AUTH` | 启用 |
+| `chrome-devtools` | Chrome DevTools 浏览器调试、性能分析、network / console / screenshot | `npx -y chrome-devtools-mcp@latest` | 无 | 启用 |
+
+**维护约定**:
+- `chrome-devtools` 跟随官方 `@latest`，source-of-truth 维护在 `config/mcp.json`，由 `sync_mcp.py` 统一分发到所有受支持 Agent。
+- 首次调用 `chrome-devtools` 时，`npx` 可能会下载最新包版本；需要本机有可用的 Node.js / npm 运行时。
+- 如果后续需要统一增加 `--browserUrl`、`--headless`、`--isolated` 等参数，应修改 `config/mcp.json`，不要手改单个 Agent 的 MCP 配置文件。
+
+---
+
 ## 各 Agent 的 MCP 配置格式
 
 **关键发现**：不同 Agent 使用不同的 MCP 配置格式！这是最大的坑。
@@ -344,6 +360,35 @@ gemini -p "请用 codebase-retrieval 查看当前项目的结构"
 
 ---
 
+## chrome-devtools 专项说明
+
+### 什么是 chrome-devtools
+
+`chrome-devtools` 是 Chrome 官方提供的 MCP server，用于让 Agent 直接连接和控制 Chrome，执行页面调试、network 观察、console 检查、性能 trace、截图和其他 DevTools 级别诊断。
+
+### 当前维护策略
+
+本项目默认通过以下命令受管分发给所有支持 MCP 的 Agent：
+
+```bash
+npx -y chrome-devtools-mcp@latest
+```
+
+这样可以跟随 Chrome DevTools 官方 MCP server 的最新发布，而不需要在每个 Agent 的本地配置里分别升级版本。
+
+### 使用约束
+
+- `chrome-devtools` 不依赖额外 secrets，占位符注入链不会为它加载专用凭证。
+- `npx` 会在首次运行或本地缓存失效时解析并下载最新版本，因此应将版本波动视为上游变更，而不是本仓库内的 drift。
+- 如果需要连接已运行的 Chrome、统一打开 headless、接受自签名证书或追加其他浏览器参数，应在 `config/mcp.json` 的 `args` 中集中维护，而不是在各 Agent 侧手工追加。
+
+### 官方参考
+
+- Chrome 官方博客：<https://developer.chrome.com/blog/chrome-devtools-mcp>
+- 官方仓库：<https://github.com/mcp/chromedevtools/chrome-devtools-mcp>
+
+---
+
 ## 常见问题与解决方案
 
 ### Q1: OpenCode 报错 "Invalid input mcp.*"

tests/test_sync_mcp.py

@@ -2,6 +2,7 @@
 import subprocess
 import tempfile
 import unittest
+from copy import deepcopy
 from pathlib import Path
 
 from src.toml_compat import tomllib
@@ -13,6 +14,65 @@
 
 
 class SyncMcpTests(unittest.TestCase):
+    def test_committed_mcp_policy_enables_chrome_devtools_latest(self):
+        definitions = json.loads((ROOT / "config" / "mcp.json").read_text(encoding="utf-8"))
+        policy = json.loads((ROOT / "config" / "manager.json").read_text(encoding="utf-8"))
+
+        chrome_devtools = definitions["servers"]["chrome-devtools"]
+        self.assertEqual(chrome_devtools["command"], "npx")
+        self.assertEqual(chrome_devtools["args"], ["-y", "chrome-devtools-mcp@latest"])
+        self.assertEqual(chrome_devtools.get("env", {}), {})
+        self.assertIsNone(chrome_devtools["agents"])
+        self.assertTrue(policy["mcp"]["chrome-devtools"]["enabled"])
+
+    def test_committed_chrome_devtools_definition_syncs_into_json_and_codex_toml(self):
+        definitions = json.loads((ROOT / "config" / "mcp.json").read_text(encoding="utf-8"))
+        chrome_devtools = deepcopy(definitions["servers"]["chrome-devtools"])
+        chrome_devtools.update(
+            {
+                "enabled": True,
+                "_declared_in_policy": True,
+                "_sync_ready": True,
+            }
+        )
+
+        with tempfile.TemporaryDirectory() as temp_dir:
+            temp_root = Path(temp_dir)
+            json_config_path = temp_root / "agent.json"
+            toml_config_path = temp_root / "config.toml"
+            toml_config_path.write_text('model = "gpt-5.4"\n', encoding="utf-8")
+
+            ok = sync_mcp.manage_mcp_config(
+                {
+                    "TmpAgent": str(json_config_path),
+                    "codex": {"path": str(toml_config_path), "format": "toml"},
+                },
+                {"chrome-devtools": chrome_devtools},
+            )
+
+            self.assertTrue(ok)
+            json_updated = json.loads(json_config_path.read_text(encoding="utf-8"))
+            self.assertEqual(json_updated["mcpServers"]["chrome-devtools"]["command"], "npx")
+            self.assertEqual(
+                json_updated["mcpServers"]["chrome-devtools"]["args"],
+                ["-y", "chrome-devtools-mcp@latest"],
+            )
+            self.assertEqual(
+                json_updated["mcpServers"]["chrome-devtools"]["env"]["_MANAGED_BY"],
+                "agent-manager",
+            )
+
+            toml_updated = tomllib.loads(toml_config_path.read_text(encoding="utf-8"))
+            self.assertEqual(toml_updated["mcp_servers"]["chrome-devtools"]["command"], "npx")
+            self.assertEqual(
+                toml_updated["mcp_servers"]["chrome-devtools"]["args"],
+                ["-y", "chrome-devtools-mcp@latest"],
+            )
+            self.assertEqual(
+                toml_updated["mcp_servers"]["chrome-devtools"]["env"]["_MANAGED_BY"],
+                "agent-manager",
+            )
+
     def test_invalid_policy_config_exits_non_zero(self):
         with tempfile.TemporaryDirectory() as temp_dir:
             temp_root = Path(temp_dir)