TidGi-Desktop/docs/MCP.md

MCP (Chrome DevTools) quick start

This repo ships a ready-to-use chrome-devtools-mcp config at .vscode/mcp.json that points to http://localhost:9222.

Prerequisites

• Install deps: pnpm install
• Ensure no other Chrome is occupying 9222 (close Chrome if needed)

Start Electron with DevTools port

• Run pnpm run start:dev:mcp
• Ports: 9222 for Chrome DevTools (renderer), 9229 for Node Inspector (main process)

Connect from VS Code MCP

• Open Command Palette → MCP: Start Servers (uses .vscode/mcp.json)
• The Chrome MCP server will attach to http://localhost:9222
• Use list_pages to see all open windows/pages (including main app and preference windows)
• Use select_page with page index to switch between different windows
• Use take_snapshot to inspect the current page's UI elements
• Use close_page to close a specific window

Troubleshooting

• If pages do not show: close other Chrome instances or change the port in .vscode/mcp.json and rerun start:dev:mcp
• If you see Debugger listening on ws://127.0.0.1:9229/..., that is the main-process Node inspector; keep using 9222 for renderer DevTools
• Multiple windows (e.g., preferences dialog) appear as separate pages in list_pages — use select_page to switch context