Merge branch 'main' into orkon/lighthouse

Author: OrKoN

README.md

@@ -73,6 +73,21 @@ Add the following config to your MCP client:
 > [!NOTE]  
 > Using `chrome-devtools-mcp@latest` ensures that your MCP client will always use the latest version of the Chrome DevTools MCP server.
 
+If you are intersted in doing only basic browser tasks, use the `--slim` mode:
+
+```json
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest", "--slim", "--headless"]
+    }
+  }
+}
+```
+
+See [Slim tool reference](./docs/slim-tool-reference.md).
+
 ### MCP Client configuration
 
 <details>
@@ -399,8 +414,6 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles
 
 <!-- BEGIN AUTO GENERATED TOOLS -->
 
-- **Audits** (1 tools)
-  - [`lighthouse_audit`](docs/tool-reference.md#lighthouse_audit)
 - **Input automation** (8 tools)
   - [`click`](docs/tool-reference.md#click)
   - [`drag`](docs/tool-reference.md#drag)
@@ -427,9 +440,10 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles
 - **Network** (2 tools)
   - [`get_network_request`](docs/tool-reference.md#get_network_request)
   - [`list_network_requests`](docs/tool-reference.md#list_network_requests)
-- **Debugging** (5 tools)
+- **Debugging** (6 tools)
   - [`evaluate_script`](docs/tool-reference.md#evaluate_script)
   - [`get_console_message`](docs/tool-reference.md#get_console_message)
+  - [`lighthouse_audit`](docs/tool-reference.md#lighthouse_audit)
   - [`list_console_messages`](docs/tool-reference.md#list_console_messages)
   - [`take_screenshot`](docs/tool-reference.md#take_screenshot)
   - [`take_snapshot`](docs/tool-reference.md#take_snapshot)
@@ -534,6 +548,10 @@ The Chrome DevTools MCP server supports the following configuration option:
   - **Type:** boolean
   - **Default:** `true`
 
+- **`--slim`**
+  Exposes a "slim" set of 3 tools covering navigation, script execution and screenshots only. Useful for basic browser tasks.
+  - **Type:** boolean
+
 <!-- END AUTO GENERATED OPTIONS -->
 
 Pass them via the `args` property in the JSON configuration. For example:

docs/slim-tool-reference.md

@@ -0,0 +1,41 @@
+<!-- AUTO GENERATED DO NOT EDIT - run 'npm run docs' to update-->
+
+# Chrome DevTools MCP Slim Tool Reference (~368 cl100k_base tokens)
+
+- **[Navigation automation](#navigation-automation)** (1 tools)
+  - [`navigate`](#navigate)
+- **[Debugging](#debugging)** (2 tools)
+  - [`evaluate`](#evaluate)
+  - [`screenshot`](#screenshot)
+
+## Navigation automation
+
+### `navigate`
+
+**Description:** Load URL in the browser
+
+**Parameters:**
+
+- **url** (string) **(required)**: Page URL
+
+---
+
+## Debugging
+
+### `evaluate`
+
+**Description:** [`Evaluate`](#evaluate) a JavaScript function on the last loaded page
+
+**Parameters:**
+
+- **fn** (string) **(required)**: A JavaScript function to be executed on the active page
+
+---
+
+### `screenshot`
+
+**Description:** Take a [`screenshot`](#screenshot) of the active page.
+
+**Parameters:** None
+
+---

docs/tool-reference.md

@@ -2,8 +2,6 @@
 
 # Chrome DevTools MCP Tool Reference (~6980 cl100k_base tokens)
 
-- **[Audits](#audits)** (1 tools)
-  - [`lighthouse_audit`](#lighthouse_audit)
 - **[Input automation](#input-automation)** (8 tools)
   - [`click`](#click)
   - [`drag`](#drag)
@@ -30,27 +28,14 @@
 - **[Network](#network)** (2 tools)
   - [`get_network_request`](#get_network_request)
   - [`list_network_requests`](#list_network_requests)
-- **[Debugging](#debugging)** (5 tools)
+- **[Debugging](#debugging)** (6 tools)
   - [`evaluate_script`](#evaluate_script)
   - [`get_console_message`](#get_console_message)
+  - [`lighthouse_audit`](#lighthouse_audit)
   - [`list_console_messages`](#list_console_messages)
   - [`take_screenshot`](#take_screenshot)
   - [`take_snapshot`](#take_snapshot)
 
-## Audits
-
-### `lighthouse_audit`
-
-**Description:** Get Lighthouse score and reports for accesibility, SEO and best practices.
-
-**Parameters:**
-
-- **device** (enum: "desktop", "mobile") _(optional)_: The device to [`emulate`](#emulate).
-- **mode** (enum: "navigation", "snapshot") _(optional)_: "navigation" reloads the selected page and audits during the navigation. The "snapshot" mode analyzes the page in its current state.
-- **outputDirPath** (string) _(optional)_: The directory to output the reports to. If not provided, temporary files will be created.
-
----
-
 ## Input automation
 
 ### `click`
@@ -338,6 +323,18 @@ so returned values have to be JSON-serializable.
 
 ---
 
+### `lighthouse_audit`
+
+**Description:** Get Lighthouse score and reports for accesibility, SEO and best practices.
+
+**Parameters:**
+
+- **device** (enum: "desktop", "mobile") _(optional)_: The device to [`emulate`](#emulate).
+- **mode** (enum: "navigation", "snapshot") _(optional)_: "navigation" reloads the selected page and audits during the navigation. The "snapshot" mode analyzes the page in its current state.
+- **outputDirPath** (string) _(optional)_: The directory to output the reports to. If not provided, temporary files will be created.
+
+---
+
 ### `list_console_messages`
 
 **Description:** List all console messages for the currently selected page since the last navigation.