@pokutuna/mcp-chrome-tabs 0.5.0 → 0.6.0

package/README.md

@@ -4,6 +4,8 @@
 
 Model Context Protocol (MCP) server that provides direct access to your browser's open tabs content. No additional fetching or authentication required - simply access what you're already viewing.
 
+<img src="./demo/demo.webp" width="600px" />
+
 ## Key Features
 
 - **Direct browser tab access** - No web scraping needed, reads content from already open tabs
@@ -55,17 +57,18 @@ The server accepts optional command line arguments for configuration:
 - `--check-interval` - Interval in milliseconds to check for tab changes and notify clients (default: 3000, set to 0 to disable)
 - `--max-content-chars` - Truncates tab content to a maximum number of characters (default: 20000)
 
-#### Experimental Safari Support
+## Other Browser Support (Experimental)
+
+### Safari
 
-Limited Safari support is available. Note that Safari lacks unique tab IDs, making it sensitive to tab order changes during execution:
+Note that Safari lacks unique tab IDs, making it sensitive to tab order changes during execution:
 
 ```bash
 npx @pokutuna/mcp-chrome-tabs --application-name=Safari --experimental-browser=safari
 ```
 
-#### Experimental Arc Browser Support
 
-Arc Browser support is available. Arc is Chrome-based and supports JavaScript execution from Apple Events:
+### Arc
 
 ```bash
 npx @pokutuna/mcp-chrome-tabs --application-name=Arc --experimental-browser=arc
@@ -101,6 +104,7 @@ Get readable content from a tab in the user's browser.
 Open a URL in a new tab to present content or enable user interaction with webpages.
 
 - `url` (required): URL to open in the browser
+- Returns: Tab ID in format `ID:windowId:tabId` for immediate access to the new tab
 
 </details>
 

package/dist/browser/arc.js

@@ -111,12 +111,20 @@ async function getPageContent(applicationName, tab) {
 }
 async function openURL(applicationName, url) {
     const escapedUrl = escapeAppleScript(url);
+    const sep = separator();
     const appleScript = `
     tell application "${applicationName}"
-      open location "${escapedUrl}"
+      tell front window
+        set newTab to (make new tab with properties {URL:"${escapedUrl}"})
+        set windowId to id
+        set tabId to id of (active tab) -- cannot retrieve id of newTab
+        return windowId & "${sep}" & tabId
+      end tell
     end tell
   `;
-    await executeAppleScript(appleScript);
+    const result = await executeAppleScript(appleScript);
+    const [windowId, tabId] = result.trim().split(sep);
+    return { windowId, tabId };
 }
 export const arcBrowser = {
     getTabList: getArcTabList,

package/dist/browser/browser.d.ts

@@ -15,6 +15,6 @@ export type TabContent = {
 export type BrowserInterface = {
     getTabList(applicationName: string): Promise<Tab[]>;
     getPageContent(applicationName: string, tab?: TabRef | null): Promise<TabContent>;
-    openURL(applicationName: string, url: string): Promise<void>;
+    openURL(applicationName: string, url: string): Promise<TabRef>;
 };
 export declare function getInterface(browser: Browser): BrowserInterface;

package/dist/browser/chrome.js

@@ -90,17 +90,23 @@ async function getPageContent(applicationName, tab) {
     return {
         title,
         url,
-        content, // Return raw HTML content
+        content,
     };
 }
 async function openURL(applicationName, url) {
     const escapedUrl = escapeAppleScript(url);
+    const sep = separator();
     const appleScript = `
     tell application "${applicationName}"
-      open location "${escapedUrl}"
+      set newTab to (make new tab at end of tabs of front window with properties {URL:"${escapedUrl}"})
+      set windowId to id of front window
+      set tabId to id of newTab
+      return windowId & "${sep}" & tabId
     end tell
   `;
-    await executeAppleScript(appleScript);
+    const result = await executeAppleScript(appleScript);
+    const [windowId, tabId] = result.trim().split(sep);
+    return { windowId, tabId };
 }
 export const chromeBrowser = {
     getTabList: getChromeTabList,

package/dist/browser/safari.js

@@ -90,17 +90,25 @@ async function getPageContent(applicationName, tab) {
     return {
         title,
         url,
-        content, // Return raw HTML content
+        content,
     };
 }
 async function openURL(applicationName, url) {
     const escapedUrl = escapeAppleScript(url);
+    const sep = separator();
     const appleScript = `
     tell application "${applicationName}"
-      open location "${escapedUrl}"
+      tell front window
+        set newTab to (make new tab with properties {URL:"${escapedUrl}"})
+        set windowId to id
+        set tabIndex to index of newTab
+        return (windowId as string) & "${sep}" & (tabIndex as string)
+      end tell
     end tell
   `;
-    await executeAppleScript(appleScript);
+    const result = await executeAppleScript(appleScript);
+    const [windowId, tabId] = result.trim().split(sep);
+    return { windowId, tabId };
 }
 export const safariBrowser = {
     getTabList: getSafariTabList,

package/dist/mcp.js

@@ -122,12 +122,13 @@ export async function createMcpServer(options) {
     }, async (args) => {
         const { url } = args;
         const browser = getInterface(options.browser);
-        await browser.openURL(options.applicationName, url);
+        const tabRef = await browser.openURL(options.applicationName, url);
+        const tabId = `ID:${tabRef.windowId}:${tabRef.tabId}`;
         return {
             content: [
                 {
                     type: "text",
-                    text: `Successfully opened the URL`,
+                    text: `Successfully opened URL in new tab. Tab: \`${tabId}\``,
                 },
             ],
         };

package/package.json

@@ -1,12 +1,19 @@
 {
   "name": "@pokutuna/mcp-chrome-tabs",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/pokutuna/mcp-chrome-tabs"
   },
   "license": "MIT",
   "type": "module",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "chrome",
+    "ai",
+    "macos"
+  ],
   "bin": {
     "mcp-chrome-tabs": "./dist/cli.js"
   },
@@ -28,18 +35,18 @@
     "test:e2e": "playwright test"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.16.0",
-    "defuddle": "^0.6.4",
+    "@modelcontextprotocol/sdk": "^1.17.3",
+    "defuddle": "^0.6.6",
     "jsdom": "^24.0.0",
     "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@playwright/test": "^1.54.1",
+    "@playwright/test": "^1.55.0",
     "@types/node": "^20.11.17",
     "playwright": "^1.54.1",
     "prettier": "^3.6.2",
-    "tsx": "^4.7.1",
-    "typescript": "~5.8.3",
+    "tsx": "^4.20.4",
+    "typescript": "~5.9.2",
     "vitest": "^3.2.4"
   }
 }