55 lines
1.6 KiB
Markdown
55 lines
1.6 KiB
Markdown
---
|
|
description: Start/restart the Browser MCP server for automated web operations
|
|
---
|
|
|
|
# Browser MCP Server Management
|
|
|
|
Start or restart the Browser MCP server for automated web operations.
|
|
|
|
## Task
|
|
Restart the Browser MCP server on port 9222. If already running, stop it first to ensure new environment settings are loaded.
|
|
|
|
## Steps
|
|
|
|
1. Stop any existing Browser MCP server processes:
|
|
```bash
|
|
pkill -f "ts-node browser-server.ts" || true
|
|
```
|
|
|
|
2. Wait for clean shutdown:
|
|
```bash
|
|
sleep 2
|
|
```
|
|
|
|
3. Start the server in the background:
|
|
```bash
|
|
cd orchestra/mcp-servers && npm run browser &
|
|
```
|
|
|
|
4. Wait for startup and verify:
|
|
```bash
|
|
sleep 3 && curl -s http://localhost:9222/health | jq
|
|
```
|
|
|
|
5. Show usage instructions:
|
|
```
|
|
✅ Browser MCP server is running on http://localhost:9222
|
|
👁️ Browser mode: GUI visible (set BROWSER_HEADLESS=true for headless mode)
|
|
|
|
Quick test:
|
|
./orchestra/mcp-servers/browser-helper.sh init
|
|
./orchestra/mcp-servers/browser-helper.sh navigate https://example.com
|
|
./orchestra/mcp-servers/browser-helper.sh screenshot example.png true
|
|
./orchestra/mcp-servers/browser-helper.sh close
|
|
|
|
See: orchestra/agents/skills/web-browse.md for full documentation
|
|
```
|
|
|
|
## Notes
|
|
- The server always restarts to pick up new .env settings
|
|
- All browser operations are logged to artifacts/browser/{sessionId}/
|
|
- Rate limits: 10 navigations, 50 clicks, 30 inputs per session
|
|
- Default port: 9222 (Chrome DevTools Protocol standard port)
|
|
- Default mode: GUI visible (browser window opens automatically)
|
|
- To stop: `pkill -f "ts-node browser-server.ts"`
|