Chrome MCP Control Center

Single-click Windows Chrome Computer-Use MCP for non-technical users.

Install one app → open one desktop shortcut → complete a short wizard → click Start All → pair your LLM → automate Chrome safely.

Features (MVP)

• Control Center desktop app (Start All / Stop All / Emergency Stop)

• Local MCP server (stdio + optional loopback HTTP)

• Chrome extension (Manifest V3) + Native Messaging

• DOM-first browser tools; computer-use fallback (guarded)

• Permission engine (read-only → reversible → commitment; L3 blocked)

• LLM pairing for Grok CLI, Claude, Codex, generic MCP clients

• Health check, Repair, audit logs with redaction

Related MCP server: Chrome MCP Server

Quick start (developers)

npm install
npm run build
npm test
npm run desktop

End-user install: see INSTALLATION.md.
Pairing: LLM_PAIRING.md.
Architecture: docs/ARCHITECTURE.md.
Living status: CONTEXT.md.

Vertical slice

1. Open Control Center → Start All

2. Extension connects via Native Messaging

3. Pair Grok CLI

4. browser_list_tabs → browser_read_page → approve → browser_click

5. Emergency Stop blocks next action

6. Stop All clean shutdown

Security

See SECURITY.md and THREAT_MODEL.md.
Webpage content is untrusted. Passwords and payment data never return to the LLM.

Versioning

SemVer MAJOR.MINOR.PATCH. One number everywhere (app, extension, installers, GitHub tag).

npm run version:patch    # or version:minor / version:major
npm run version:sync     # sync desktop, extension, VERSION, src/version.ts

Installers (from next pack):

• ChromeMCP-ControlCenter_1.0.4_win-x64_Setup.exe

• ChromeMCP-ControlCenter_1.0.4_win-x64_Portable.exe

Details: docs/VERSIONING.md.

Cloud improvement sync

Free and Paid both sync operational telemetry to the owner backend (after consent). Free is not local-only for diagnostics. Secrets are never uploaded.

npm run cloud:backend          # owner ingest + dashboard :8788
# Control Center → Cloud & Privacy → Accept agreement → Sync now

See docs/CLOUD_SYNC.md.

Obsidian knowledge base

Docs sync into the TTRG vault under 10-Projects/chrome-mcp-control-center/ (wikilinks, redacted).

npm run obsidian:export

Runs automatically after npm run build and npm run desktop:pack. Secrets and private logs are excluded.

License

MIT