Customable - MCPs
Repositories
49
 Projects Packages
17

@customable/browser-mcp (1.0.5)

Published 2025-10-07 17:12:35 +02:00 by jack in customable-mcp/browser-mcp

Installation

@customable:registry=
npm install @customable/browser-mcp@1.0.5
"@customable/browser-mcp": "1.0.5"

About this package

🌍 browser-mcp

MCP Server for browser automation - screenshots, DOM queries, and website testing with Puppeteer.

Features

Core Features

  • 🌐 open_page - Open a webpage
  • 📄 get_title - Get page title
  • 📸 screenshot - Take screenshot (full page or element)
  • 🔍 query_selector - Query DOM element and get text/attributes
  • ⌨️ fill_form - Fill form fields and submit
  • 🖱️ click_element - Click on element by selector

Advanced Features

  • 🍪 Cookie management (get, set, clear)
  • 📊 Performance metrics (page load time, resource timing)
  • 📱 Viewport configuration (desktop, mobile, custom)
  • 🔄 Wait for elements and navigation
  • 📋 Extract page content (text, HTML, JSON)

Installation

npm install
npm run build

Configuration

Optional environment variables:

  • HEADLESS - Run in headless mode (default: true)
  • SCREENSHOT_DIR - Directory for screenshots (default: ./screenshots)

Usage

npm start

Examples

Take a screenshot

{
  "tool": "screenshot",
  "arguments": {
    "url": "https://example.com",
    "fullPage": true
  }
}

Query DOM element

{
  "tool": "query_selector",
  "arguments": {
    "url": "https://example.com",
    "selector": "h1",
    "attribute": "textContent"
  }
}

Fill form

{
  "tool": "fill_form",
  "arguments": {
    "url": "https://example.com/form",
    "fields": {
      "#email": "user@example.com",
      "#password": "secret"
    },
    "submit": true
  }
}

License

MIT

Dependencies

Dependencies

ID Version
@modelcontextprotocol/sdk ^0.5.0
puppeteer ^22.0.0

Development dependencies

ID Version
@types/node ^18.0.0
typescript ^5.3.0

Keywords

mcp browser puppeteer automation testing
Details
npm
customable-mcp/browser-mcp
2025-10-07 17:12:35 +02:00
1
Customable Team
Project website
MIT
14 KiB
Assets (1)
browser-mcp-1.0.5.tgz 14 KiB
Versions (4) View all
3.0.0 2025-10-11
2.0.0 2025-10-10
1.2.0 2025-10-09
1.0.5 2025-10-07
Issues