feat: add Chrome DevTools MCP server and generalize MCP setup

Add Chrome DevTools MCP (chrome-devtools-mcp) as an opt-in MCP server
for browser debugging during frontend development. Generalize the MCP
setup to support multiple servers from config rather than hardcoding
only Serena.

Key changes:
- Add chrome-devtools to mcpConfig in core config
- Rename setup/serena.py to setup/mcp.py, generate .mcp.json with all
  configured servers
- Allow extra MCP servers in McpConfig schema (extra="allow")
- Default enabledMcpjsonServers to ["serena"] only -- chrome-devtools
  is opt-in to avoid unnecessary token usage for non-frontend devs
- Fix bug: bootstrap was passing ReposConfig to setup_serena_config
  instead of ClaudeCodeConfig
- Check command validates .mcp.json contains all expected servers
- Bump version to 0.6.0

Author: vredchenko

core/claude-code-config.json

@@ -18,7 +18,8 @@
         "Bash(ls:*)",
         "Bash(cat:*)",
         "WebSearch",
-        "mcp__serena__*"
+        "mcp__serena__*",
+        "mcp__chrome-devtools__*"
       ]
     }
   },
@@ -41,6 +42,12 @@
         "--project",
         "${PWD}"
       ]
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": [
+        "chrome-devtools-mcp@latest"
+      ]
     }
   }
 }

packages/smartem-workspace/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "smartem-workspace"
-version = "0.5.0"
+version = "0.6.0"
 description = "CLI tool to automate SmartEM multi-repo workspace setup"
 readme = "README.md"
 license = "Apache-2.0"

packages/smartem-workspace/smartem_workspace/__init__.py

@@ -1,3 +1,3 @@
 """SmartEM workspace setup CLI tool."""
 
-__version__ = "0.5.0"
+__version__ = "0.6.0"

packages/smartem-workspace/smartem_workspace/commands/check.py

@@ -290,7 +290,7 @@ def run_claude_checks(workspace_path: Path, claude_config: ClaudeCodeConfig) ->
     return CheckReport("claude", results)
 
 
-def run_serena_checks(workspace_path: Path) -> CheckReport:
+def run_serena_checks(workspace_path: Path, claude_config: ClaudeCodeConfig | None = None) -> CheckReport:
     results = []
 
     serena_dir = workspace_path / ".serena"
@@ -305,6 +305,26 @@ def run_serena_checks(workspace_path: Path) -> CheckReport:
     mcp_json = workspace_path / ".mcp.json"
     if mcp_json.exists():
         results.append(check_json_valid(mcp_json, ".mcp.json"))
+
+        if claude_config:
+            try:
+                mcp_data = json.loads(mcp_json.read_text())
+                defined_servers = set(mcp_data.get("mcpServers", {}).keys())
+                expected_servers = set(claude_config.mcpConfig.model_dump().keys())
+                missing = expected_servers - defined_servers
+                if missing:
+                    results.append(
+                        CheckResult(
+                            ".mcp.json servers",
+                            "warning",
+                            f"Missing servers: {', '.join(sorted(missing))}. Re-run setup to add them.",
+                            fixable=False,
+                        )
+                    )
+                else:
+                    results.append(CheckResult(".mcp.json servers", "ok", f"{len(defined_servers)} server(s) configured"))
+            except (json.JSONDecodeError, KeyError):
+                pass
     else:
         results.append(CheckResult(".mcp.json", "warning", "Missing", fixable=False))
 
@@ -357,7 +377,7 @@ def run_checks(
         reports.append(run_claude_checks(workspace_path, claude_config))
 
     if scope in (CheckScope.ALL, CheckScope.SERENA) and workspace_path:
-        reports.append(run_serena_checks(workspace_path))
+        reports.append(run_serena_checks(workspace_path, claude_config))
 
     if scope in (CheckScope.ALL, CheckScope.REPOS) and workspace_path and config:
         reports.append(run_repos_checks(workspace_path, config))

packages/smartem-workspace/smartem_workspace/config/claude-code-config.json

@@ -4,19 +4,22 @@
   "description": "Claude Code integration configuration for SmartEM workspace",
   "claudeConfig": {
     "skills": [
-      { "name": "database", "path": "claude-code/shared/skills/database" },
+      { "name": "database-admin", "path": "claude-code/shared/skills/database-admin" },
       { "name": "devops", "path": "claude-code/shared/skills/devops" },
-      { "name": "tech-writer", "path": "claude-code/shared/skills/tech-writer" },
+      { "name": "technical-writer", "path": "claude-code/shared/skills/technical-writer" },
       { "name": "git", "path": "claude-code/shared/skills/git" },
-      { "name": "playwright", "path": "claude-code/smartem-frontend/skills/playwright" }
+      { "name": "github", "path": "claude-code/shared/skills/github" },
+      { "name": "ascii-art", "path": "claude-code/shared/skills/ascii-art" },
+      { "name": "playwright-skill", "path": "claude-code/smartem-frontend/skills/playwright-skill" }
     ],
     "defaultPermissions": {
       "allow": [
         "Bash(git:*)",
         "Bash(ls:*)",
         "Bash(cat:*)",
         "WebSearch",
-        "mcp__serena__*"
+        "mcp__serena__*",
+        "mcp__chrome-devtools__*"
       ]
     }
   },
@@ -39,6 +42,12 @@
         "--project",
         "${PWD}"
       ]
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": [
+        "chrome-devtools-mcp@latest"
+      ]
     }
   }
 }

packages/smartem-workspace/smartem_workspace/config/schema.py

@@ -93,7 +93,13 @@ class McpServerConfig(BaseModel):
 
 
 class McpConfig(BaseModel):
-    """MCP servers configuration."""
+    """MCP servers configuration.
+
+    Serena is required; additional servers (e.g. chrome-devtools) are accepted
+    via extra="allow" so the schema doesn't need updating for each new server.
+    """
+
+    model_config = ConfigDict(extra="allow")
 
     serena: McpServerConfig
 

packages/smartem-workspace/smartem_workspace/setup/bootstrap.py

@@ -13,7 +13,7 @@
 )
 from smartem_workspace.setup.claude import setup_claude_config
 from smartem_workspace.setup.repos import clone_repos
-from smartem_workspace.setup.serena import setup_serena_config
+from smartem_workspace.setup.mcp import setup_mcp_config
 from smartem_workspace.setup.workspace import display_next_steps, setup_workspace_structure
 
 console = Console()
@@ -113,9 +113,9 @@ def bootstrap_workspace(
     if not skip_claude and claude_config:
         setup_claude_config(claude_config, workspace_path)
 
-    if not skip_serena:
+    if not skip_serena and claude_config:
         project_name = workspace_path.name or "smartem-workspace"
-        setup_serena_config(config, workspace_path, project_name)
+        setup_mcp_config(claude_config, workspace_path, project_name)
 
     display_next_steps(workspace_path)
 

packages/smartem-workspace/smartem_workspace/setup/claude.py

@@ -73,6 +73,7 @@ def setup_claude_config(
     if not settings_path.exists():
         settings = {
             "permissions": config.claudeConfig.defaultPermissions.model_dump(),
+            "enabledMcpjsonServers": ["serena"],
         }
         settings_path.write_text(json.dumps(settings, indent=2))
         console.print(f"  [green]Created {settings_path.name}[/green]")

…kspace/smartem_workspace/setup/serena.py …workspace/smartem_workspace/setup/mcp.pypackages/smartem-workspace/smartem_workspace/setup/serena.py renamed to packages/smartem-workspace/smartem_workspace/setup/mcp.py packages/smartem-workspace/smartem_workspace/setup/serena.py renamed to packages/smartem-workspace/smartem_workspace/setup/mcp.py

@@ -1,33 +1,33 @@
-"""Serena MCP server configuration setup."""
+"""MCP server configuration setup."""
 
 import json
 from pathlib import Path
 
 import yaml
 from rich.console import Console
 
-from smartem_workspace.config.schema import ReposConfig
+from smartem_workspace.config.schema import ClaudeCodeConfig, McpServerConfig
 
 console = Console()
 
 
-def setup_serena_config(
-    config: ReposConfig,
+def setup_mcp_config(
+    config: ClaudeCodeConfig,
     workspace_path: Path,
     project_name: str = "smartem-workspace",
 ) -> bool:
     """
-    Set up Serena MCP server configuration.
+    Set up MCP server configuration.
 
     Creates:
-    - .serena/project.yml
-    - .mcp.json
+    - .serena/project.yml (Serena-specific config)
+    - .mcp.json (all MCP servers from config)
 
     Returns:
         True if successful
     """
     console.print()
-    console.print("[bold]Setting up Serena MCP configuration...[/bold]")
+    console.print("[bold]Setting up MCP configuration...[/bold]")
 
     serena_dir = workspace_path / ".serena"
     serena_dir.mkdir(parents=True, exist_ok=True)
@@ -50,19 +50,19 @@ def setup_serena_config(
 
     mcp_json_path = workspace_path / ".mcp.json"
     if not mcp_json_path.exists():
-        mcp_config = {
-            "mcpServers": {
-                "serena": {
-                    "command": config.mcpConfig.serena.command,
-                    "args": [arg.replace("${PWD}", str(workspace_path)) for arg in config.mcpConfig.serena.args],
-                }
+        mcp_servers = {}
+        for name, server_config in config.mcpConfig.model_dump().items():
+            if not isinstance(server_config, dict) or "command" not in server_config:
+                continue
+            mcp_servers[name] = {
+                "command": server_config["command"],
+                "args": [arg.replace("${PWD}", str(workspace_path)) for arg in server_config.get("args", [])],
             }
-        }
 
-        mcp_json_path.write_text(json.dumps(mcp_config, indent=2))
-        console.print(f"  [green]Created {mcp_json_path.name}[/green]")
+        mcp_json_path.write_text(json.dumps({"mcpServers": mcp_servers}, indent=2))
+        console.print(f"  [green]Created {mcp_json_path.name} ({len(mcp_servers)} servers)[/green]")
     else:
         console.print(f"  [dim]{mcp_json_path.name} already exists[/dim]")
 
-    console.print("[green]Serena configuration complete[/green]")
+    console.print("[green]MCP configuration complete[/green]")
     return True