mirror of https://github.com/tiddly-gittly/TidGi-Desktop.git synced 2026-03-10 08:50:20 -07:00

lin onetwo 48b11e5a32 electron chrome mcp mode sometimes wont show browser view

Clarified troubleshooting steps in docs/MCP.md regarding browser view issues and updated the instructions. Reordered the 'start:dev:mcp' script in package.json for better organization.

2026-01-11 23:19:05 +08:00

1.5 KiB

Raw Blame History

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 (check active terminal see if it is already running)
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 browser pages do not show, app main window react part is shown, but wiki browser view is white or not shown: Seems it is not working with browser view. ~~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

1.5 KiB Raw Blame History