browser-devtools-mcp 0.1.6 → 0.2.0

package/LICENSE

@@ -1,21 +1,93 @@
-MIT License
-
-Copyright (c) 2025 Serkan ÖZAL
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Elastic License 2.0 (ELv2)
+
+Copyright 2025 Serkan ÖZAL
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor's trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+**control** means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -7,7 +7,7 @@
 <p align="center">
   <a href="https://github.com/serkan-ozal/browser-devtools-mcp/actions/workflows/build.yml"><img src="https://github.com/serkan-ozal/browser-devtools-mcp/actions/workflows/build.yml/badge.svg" alt="Build Status"></a>
   <a href="https://www.npmjs.com/package/browser-devtools-mcp"><img src="https://badge.fury.io/js/browser-devtools-mcp.svg" alt="NPM Version"></a>
-  <a href="https://github.com/serkan-ozal/browser-devtools-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License"></a>
+  <a href="https://github.com/serkan-ozal/browser-devtools-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Elastic--2.0-blue" alt="License"></a>
 </p>
 
 <p align="center">
@@ -91,6 +91,34 @@ Browser DevTools MCP exposes a Playwright-powered browser runtime to AI agents,
   - The extension enables reliable root discovery and component search via `__REACT_DEVTOOLS_GLOBAL_HOOK__`
   - Without the extension, tools fall back to scanning DOM for `__reactFiber$` pointers (best-effort, less reliable)
 
+### Debug Tools (Non-Blocking)
+Non-blocking debugging tools that capture snapshots without pausing execution. Ideal for AI-assisted debugging.
+
+**Probe Types:**
+- **Tracepoint**: Captures call stack, local variables, and async stack traces at a code location
+- **Logpoint**: Evaluates and logs expressions without full debug context (lightweight)
+- **Exceptionpoint**: Captures snapshots when exceptions occur (uncaught or all)
+- **Dompoint**: Monitors DOM mutations (subtree-modified, attribute-modified, node-removed)
+- **Netpoint**: Monitors network requests/responses matching a URL pattern
+
+**Core Operations (per probe type):**
+- `put-*`: Create a probe at a location
+- `remove-*`: Remove a specific probe
+- `list-*`: List all probes of a type
+- `clear-*`: Remove all probes of a type
+- `get-*-snapshots`: Retrieve captured snapshots (supports `fromSequence` for polling)
+- `clear-*-snapshots`: Clear captured snapshots
+
+**Additional Tools:**
+- **Watch Expressions**: Add expressions to evaluate at every tracepoint/exceptionpoint hit
+- **Status**: Get current debugging status (enabled, probe counts, snapshot stats)
+
+**Key Features:**
+- Source map support for debugging bundled/minified code with original source locations
+- Automatic debugging enablement on first tool use
+- Configurable limits (max snapshots, call stack depth, async segments)
+- Sequence numbers for efficient snapshot polling
+
 ## Prerequisites
 
 - Node.js 18+
@@ -109,6 +137,16 @@ Browser DevTools MCP server supports the following CLI arguments for configurati
 - `--transport <stdio|streamable-http>` - Configures the transport protocol (defaults to `stdio`).
 - `--port <number>` – Configures the port number to listen on when using `streamable-http` transport (defaults to `3000`).
 
+### Install as AI Agent Skill
+
+Install browser automation capabilities as a skill for AI coding agents (Claude Code, Cursor, Windsurf, etc.) using the [skills.sh](https://skills.sh) ecosystem:
+
+```bash
+npx skills add serkan-ozal/browser-devtools-skills
+```
+
+This installs the CLI skill that enables AI agents to automate browsers for web testing, screenshots, form filling, accessibility audits, performance analysis, and more. See the [Skills Repository](https://github.com/serkan-ozal/browser-devtools-skills) for details.
+
 ## MCP Client Configuration
 
 ### Claude Desktop
@@ -507,6 +545,39 @@ browser-devtools-cli
 │   └── clear                 # Clear stubs
 ├── sync                      # Synchronization commands
 │   └── wait-for-network-idle # Wait for network idle
+├── debug                     # Non-blocking debugging commands
+│   ├── put-tracepoint        # Set a tracepoint (captures call stack)
+│   ├── remove-tracepoint     # Remove a tracepoint
+│   ├── list-tracepoints      # List all tracepoints
+│   ├── clear-tracepoints     # Clear all tracepoints
+│   ├── put-logpoint          # Set a logpoint (evaluates expression)
+│   ├── remove-logpoint       # Remove a logpoint
+│   ├── list-logpoints        # List all logpoints
+│   ├── clear-logpoints       # Clear all logpoints
+│   ├── put-exceptionpoint    # Enable exception catching
+│   ├── put-dompoint          # Set DOM mutation breakpoint
+│   ├── remove-dompoint       # Remove a DOM breakpoint
+│   ├── list-dompoints        # List all DOM breakpoints
+│   ├── clear-dompoints       # Clear all DOM breakpoints
+│   ├── put-netpoint          # Set network request breakpoint
+│   ├── remove-netpoint       # Remove a network breakpoint
+│   ├── list-netpoints        # List all network breakpoints
+│   ├── clear-netpoints       # Clear all network breakpoints
+│   ├── add-watch             # Add a watch expression
+│   ├── remove-watch          # Remove a watch expression
+│   ├── list-watches          # List all watch expressions
+│   ├── clear-watches         # Clear all watch expressions
+│   ├── get-tracepoint-snapshots      # Get tracepoint snapshots
+│   ├── clear-tracepoint-snapshots    # Clear tracepoint snapshots
+│   ├── get-logpoint-snapshots        # Get logpoint snapshots
+│   ├── clear-logpoint-snapshots      # Clear logpoint snapshots
+│   ├── get-exceptionpoint-snapshots  # Get exception snapshots
+│   ├── clear-exceptionpoint-snapshots # Clear exception snapshots
+│   ├── get-dompoint-snapshots        # Get DOM mutation snapshots
+│   ├── clear-dompoint-snapshots      # Clear DOM snapshots
+│   ├── get-netpoint-snapshots        # Get network snapshots
+│   ├── clear-netpoint-snapshots      # Clear network snapshots
+│   └── status                # Get debugging status
 └── figma                     # Figma integration commands
     └── compare-page-with-design
 ```
@@ -915,20 +986,24 @@ The daemon listens on port 2020 by default. Use `--port` to specify a different
 
 ### CLI Skills Documentation
 
-Comprehensive documentation for AI agents and automation is available in the [skills/browser-devtools-cli](skills/browser-devtools-cli) directory:
-
-- **[SKILL.md](skills/browser-devtools-cli/SKILL.md)** - Main CLI reference with global options, commands, and workflow examples
-- **Domain References** (in `references/` subdirectory):
-  - [navigation.md](skills/browser-devtools-cli/references/navigation.md) - Page navigation (go-to, back, forward, reload)
-  - [content.md](skills/browser-devtools-cli/references/content.md) - Content extraction (screenshot, PDF, HTML, text)
-  - [interaction.md](skills/browser-devtools-cli/references/interaction.md) - User interactions (click, fill, hover, scroll)
-  - [a11y.md](skills/browser-devtools-cli/references/a11y.md) - Accessibility snapshots (ARIA, AX tree)
-  - [o11y.md](skills/browser-devtools-cli/references/o11y.md) - Observability (Web Vitals, console, HTTP, traces)
-  - [run.md](skills/browser-devtools-cli/references/run.md) - JavaScript execution (browser, sandbox)
-  - [stub.md](skills/browser-devtools-cli/references/stub.md) - HTTP mocking (intercept, mock, clear)
-  - [sync.md](skills/browser-devtools-cli/references/sync.md) - Synchronization (wait for network idle)
-  - [react.md](skills/browser-devtools-cli/references/react.md) - React DevTools integration
-  - [figma.md](skills/browser-devtools-cli/references/figma.md) - Figma design comparison
+Comprehensive documentation for AI agents and automation is available in the [browser-devtools-skills](https://github.com/serkan-ozal/browser-devtools-skills) repository.
+
+Install as an AI agent skill:
+
+```bash
+npx skills add serkan-ozal/browser-devtools-skills
+```
+
+**Available Skills:**
+
+| Skill | Description |
+|-------|-------------|
+| `browser-devtools-cli` | Complete CLI reference for browser automation |
+| `browser-testing` | General browser testing and automation |
+| `web-debugging` | Console, network, and JavaScript debugging |
+| `performance-audit` | Web Vitals and performance analysis |
+| `visual-testing` | Visual testing and responsive design |
+| `observability` | Distributed tracing and monitoring |
 
 These skill files are optimized for AI agent consumption with non-interactive command examples, JSON output flags, and session-based workflow patterns.
 
@@ -974,15 +1049,18 @@ The server can be configured using environment variables:
 - `fullPage` (boolean, optional): Capture full scrollable page (default: false)
 - `type` (enum, optional): Image format - "png" or "jpeg" (default: "png")
 - `quality` (number, optional): The quality of the image, between 0-100. Not applicable to PNG images, only used for JPEG format (default: 100)
+- `includeBase64` (boolean, optional): Include base64-encoded image data in the response (default: false)
 
 **Returns:**
 - `filePath` (string): Full path of the saved screenshot file
-- `image` (object): Screenshot image data with mimeType
+- `image` (object, optional): Screenshot image data with mimeType (only included when `includeBase64` is true)
 
 **Notes:**
+- The screenshot is always saved to the file system and the file path is returned
+- By default, image data is NOT included in the response to reduce payload size
+- Set `includeBase64` to true when the AI assistant cannot access the MCP server's file system (e.g., remote server, containerized environment, or different machine)
 - The `quality` parameter only applies to JPEG images. PNG images are always saved at full quality
 - Lower quality values (e.g., 50-70) result in smaller file sizes but reduced image quality
-- Quality value of 100 provides maximum quality but larger file sizes
 </details>
 
 <details>
@@ -1841,7 +1919,9 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file for details.
+Elastic License 2.0 (ELv2) - see [LICENSE](LICENSE) file for details.
+
+This license allows free use for any purpose (personal, commercial, local, production) but prohibits providing the software as a hosted/managed service.
 
 ## Author