chrometools-mcp 3.1.2 → 3.1.4

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to this project will be documented in this file.
 
+## [3.1.4] - 2026-01-27
+
+### Fixed
+- **Cursor installation instructions** — Corrected the setup process to use Cursor UI instead of manual JSON editing
+  - Changed from Command Palette approach to Settings UI approach (Settings → Cursor Settings → MCP)
+  - Added proper field names (Name, Type, Command) for the "Add New MCP Server" dialog
+  - Added test instructions to verify installation in Cursor Agent mode
+
+## [3.1.3] - 2026-01-27
+
+### Changed
+- **README.md installation section reorganization** — Improved installation documentation
+  - Moved Installation section to the top for better visibility
+  - Added Claude Code (CLI) installation with `claude mcp add chrometools-mcp` command
+  - Separated installation instructions by client type (Claude Code, Claude Desktop, Cursor, Antigravity, Other MCP Clients)
+  - Added detailed step-by-step instructions for Cursor IDE (Settings → Cursor Settings → MCP → Add New MCP Server)
+  - Added detailed step-by-step instructions for Google Antigravity (MCP Store → Manage → View raw config)
+  - Added configuration file paths for Claude Desktop (macOS/Linux/Windows)
+  - Added notes about Antigravity's 100-tool limit and optimal configuration
+  - Removed duplicate Installation/Usage sections
+
 ## [3.1.2] - 2026-01-26
 
 ### Added

package/README.md

@@ -2,10 +2,113 @@
 
 MCP server for Chrome automation using Puppeteer with persistent browser sessions.
 
+## Installation
+
+### Claude Code (CLI)
+
+The easiest way to install for Claude Code users:
+
+```bash
+claude mcp add chrometools-mcp
+```
+
+This command will automatically configure the MCP server in your Claude Code settings.
+
+### Claude Desktop
+
+Add to your Claude Desktop configuration file:
+
+**macOS/Linux:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "chrometools": {
+      "command": "npx",
+      "args": ["-y", "chrometools-mcp"]
+    }
+  }
+}
+```
+
+### Cursor
+
+**Step 1:** Open MCP Settings in Cursor
+- Click on **Settings** (⚙️ icon or `Cmd + ,` / `Ctrl + ,`)
+- Navigate to **Cursor Settings** → **MCP**
+
+**Step 2:** Add New MCP Server
+- Click **"Add New MCP Server"** button
+- Fill in the fields:
+  - **Name:** `chrometools-mcp` (or any name you prefer)
+  - **Type:** Select `Command`
+  - **Command:** `npx -y chrometools-mcp`
+
+**Step 3:** Save and Refresh
+- Click **"Refresh"** to activate the MCP server
+- The chrometools-mcp tools will now be available in Cursor Agent
+
+**Step 4:** Test the Installation
+- Open Cursor Chat
+- Select **Agent** mode
+- Try a command like: "Open browser and navigate to google.com"
+
+### Google Antigravity
+
+**Step 1:** Open Agent session in Antigravity
+
+**Step 2:** Click the "**…**" dropdown at the top of the editor's side panel
+
+**Step 3:** Select **"MCP Servers"** to open the MCP Store
+
+**Step 4:** Click **"Manage MCP Servers"** at the top of the MCP Store
+
+**Step 5:** Click **"View raw config"** in the main tab
+
+**Step 6:** Edit `mcp_config.json` (located in `~/.gemini/antigravity/` directory):
+
+```json
+{
+  "mcpServers": {
+    "chrometools": {
+      "command": "npx",
+      "args": ["-y", "chrometools-mcp"]
+    }
+  }
+}
+```
+
+**Step 7:** Save the file and restart Antigravity
+
+**Note:** Antigravity has a limit of ~100 tools per session. If you have many MCP servers installed, consider reducing the number of active tools to ~25 for optimal performance.
+
+### Other MCP Clients
+
+For Cline, Continue, or other MCP-compatible clients, add to your MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "chrometools": {
+      "command": "npx",
+      "args": ["-y", "chrometools-mcp"]
+    }
+  }
+}
+```
+
+### Manual Installation
+
+You can also run directly without configuration:
+
+```bash
+npx -y chrometools-mcp
+```
+
 ## Table of Contents
 
 - [Installation](#installation)
-- [Usage](#usage)
 - [AI Optimization Features](#ai-optimization-features) ⭐ **NEW**
 - [Scenario Recorder](#scenario-recorder) ⭐ **NEW** - Visual UI-based recording with smart optimization
 - [Available Tools](#available-tools) - **46+ Tools Total**
@@ -25,27 +128,6 @@ MCP server for Chrome automation using Puppeteer with persistent browser session
 - [Features](#features)
 - [Architecture](#architecture)
 
-## Installation
-
-```bash
-npx -y chrometools-mcp
-```
-
-## Usage
-
-Add to your MCP client configuration (e.g., Claude Desktop):
-
-```json
-{
-  "mcpServers": {
-    "chrometools": {
-      "command": "npx",
-      "args": ["-y", "chrometools-mcp"]
-    }
-  }
-}
-```
-
 ## AI Optimization Features
 
 ⭐ **NEW**: Dramatically reduce AI agent request cycles with intelligent element finding and page analysis.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrometools-mcp",
-  "version": "3.1.2",
+  "version": "3.1.4",
   "description": "MCP (Model Context Protocol) server for Chrome automation using Puppeteer. Persistent browser sessions, UI framework detection (MUI, Ant Design, etc.), Page Object support, visual testing, Figma comparison. Works seamlessly in WSL, Linux, macOS, and Windows.",
   "type": "module",
   "main": "index.js",