Files

Alejandro Gutiérrez 390eda1595 Initial commit - NUC server configuration and docs

- CLAUDE.md: Server instructions and service reference
- docs/: Persistent documentation (architecture, guides)
- .artifacts/: Session-generated notes
- playwriter-browser/: Remote browser container config

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-02-01 20:49:20 +00:00

2.8 KiB

Raw Permalink Blame History

MCP Browser Configuration

Date: 2026-02-01 15:45 Context: Configured Playwriter and Chrome DevTools MCP servers with naming convention for local vs remote browsers

Naming Convention

playwriter-<location>-<id>
chrome-devtools-<location>-<id>

Pattern	Example	Description
`<location>`	`local`, `nuc`, `cloud`	Where browser runs
`<id>`	`01`, `02`, etc.	Unique instance number

Current Configuration

Local Browser

Field	Value
MCP Name	`playwriter-local`
Type	Local
Description	Uses local machine resources
Command	`npx playwriter`

Remote NUC Browser

Field	Value
MCP Name	`playwriter-nuc-01`
Type	Remote
ID	`nuc-01`
Host	`192.168.1.3`
Port	`19988`
WebSocket	`ws://192.168.1.3:19988`
Token	`nuc-browser-token`
noVNC	`http://192.168.1.3:6081/vnc.html`
CDP	`http://192.168.1.3:9222`
Command	`npx playwriter --host ws://192.168.1.3:19988 --token nuc-browser-token`

Chrome DevTools for NUC

Field	Value
MCP Name	`chrome-devtools-nuc-01`
Type	Remote
ID	`nuc-01`
Browser URL	`http://192.168.1.3:19988`
Command	`npx chrome-devtools-mcp@latest --browserUrl http://192.168.1.3:19988`

Metadata Fields

Config files use underscore-prefixed fields for metadata (ignored by MCP):

{
  "playwriter-nuc-01": {
    "_description": "Remote browser on NUC server - no local resources used",
    "_id": "nuc-01",
    "_host": "192.168.1.3",
    "_port": 19988,
    "command": "npx",
    "args": ["playwriter", "--host", "ws://192.168.1.3:19988", "--token", "nuc-browser-token"]
  }
}

Priority Order

mcp__playwriter-nuc-01__* - Remote NUC browser (preferred, no local resources)
mcp__chrome-devtools-nuc-01__* - Chrome DevTools for NUC browser
mcp__playwriter-local__* - Local browser (fallback, uses local resources)

Future Expansion Examples

MCP Name	Location	Use Case
`playwriter-nuc-02`	NUC	Second browser for parallel automation
`playwriter-cloud-01`	Cloud	Cloud-hosted browser instance
`playwriter-mac-mini-01`	Mac Mini	Dedicated Mac browser

NUC Browser Container

Location: ~/playwriter-browser/ on NUC (deployed via docker compose)

First-time setup:

Access noVNC at http://192.168.1.3:6081/vnc.html
Install Playwriter extension
Click extension icon to activate (turns green)

Config file: /Users/agutierrez/Desktop/nuc/.mcp.json
CLAUDE.md: Browser MCP documentation section
NUC container: playwriter-browser service in Coolify

2.8 KiB Raw Permalink Blame History