native-devtools-mcp 0.2.2 → 0.3.0

package/README.md

@@ -11,7 +11,7 @@
 
 A Model Context Protocol (MCP) server that provides **Computer Use** capabilities: screenshots, OCR, input simulation, and window management.
 
-[Features](#features) • [Installation](#installation) • [For AI Agents](#for-ai-agents-llms) • [Permissions](#required-permissions-macos)
+[Features](#-features) • [Installation](#-installation) • [For AI Agents](#-for-ai-agents-llms) • [Permissions](#-required-permissions-macos)
 
 ![Demo](demo.gif)
 
@@ -40,23 +40,23 @@ This MCP server is designed to be **highly discoverable and usable** by AI model
 2.  `click` / `type_text`: The "hands". Interacts with the system based on visual feedback.
 3.  `find_text`: A shortcut to find text on screen and get its coordinates immediately.
 
-## 📦 Installation
+## 📦 Installation (macOS + Windows)
 
-### Option 1: Run with `npx` (No install needed)
+The install steps are identical on macOS and Windows.
 
-The easiest way to use this with Claude Desktop or other MCP clients.
+### Option 1: Run with `npx` (no install needed)
 
 ```bash
 npx -y native-devtools-mcp
 ```
 
-### Option 2: Global Install
+### Option 2: Global install
 
 ```bash
 npm install -g native-devtools-mcp
 ```
 
-### Option 3: Build from Source (Rust)
+### Option 3: Build from source (Rust)
 
 <details>
 <summary>Click to expand build instructions</summary>
@@ -71,10 +71,37 @@ cargo build --release
 
 ## ⚙️ Configuration
 
-Add this to your **Claude Desktop** configuration file:
+### macOS Configuration
 
-**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+**Claude Desktop config file:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+**Claude Desktop requires the signed app bundle** (npx/npm will not work due to Gatekeeper):
+
+1. Download `NativeDevtools-X.X.X.dmg` from [GitHub Releases](https://github.com/sh3ll3x3c/native-devtools-mcp/releases)
+2. Open the DMG and drag `NativeDevtools.app` to `/Applications`
+3. Configure Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "native-devtools": {
+      "command": "/Applications/NativeDevtools.app/Contents/MacOS/native-devtools-mcp"
+    }
+  }
+}
+```
+
+4. Restart Claude Desktop - it will prompt for Screen Recording and Accessibility permissions for NativeDevtools
+
+> **Note:** Claude Code (CLI) can use either the signed app or npx - both work.
+
+### Windows Configuration
+
+**Claude Desktop config file:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+### Configuration JSON (Windows and macOS CLI)
+
+For Windows (or macOS with Claude Code CLI):
 
 ```json
 {
@@ -171,7 +198,7 @@ On macOS, you must grant permissions to the **host application** (e.g., Terminal
 
 > **Restart Required:** After granting permissions, you must fully quit and restart the host application.
 
-## 🪟 Windows Support
+## 🪟 Windows Notes
 
 Works out of the box on **Windows 10/11**.
 *   Uses standard Win32 APIs (GDI, SendInput).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "native-devtools-mcp",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "MCP server for testing native desktop applications",
   "license": "MIT",
   "repository": {
@@ -25,8 +25,8 @@
     "bin"
   ],
   "optionalDependencies": {
-    "@sh3ll3x3c/native-devtools-mcp-darwin-arm64": "0.2.2",
-    "@sh3ll3x3c/native-devtools-mcp-win32-x64": "0.2.2"
+    "@sh3ll3x3c/native-devtools-mcp-darwin-arm64": "0.3.0",
+    "@sh3ll3x3c/native-devtools-mcp-win32-x64": "0.3.0"
   },
   "engines": {
     "node": ">=18"