@pokutuna/mcp-chrome-tabs 0.2.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 pokutuna
+
+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.

package/README.md

@@ -7,7 +7,7 @@ Model Context Protocol (MCP) server that provides direct access to your browser'
 ## Key Features
 
 - **Direct browser tab access** - No web scraping needed, reads content from already open tabs
-- **Content optimized for AI** - Automatic readability processing and markdown conversion to reduce token usage
+- **Content optimized for AI** - Automatic content extraction and markdown conversion to reduce token usage
 - **Active tab shortcut** - Instant access to currently focused tab without specifying IDs
 - **MCP listChanged notifications** - Follows MCP protocol to notify tab changes (support is limited in most clients)
 

package/dist/browser/chrome.js

@@ -1,7 +1,5 @@
-import { JSDOM } from "jsdom";
-import { Readability } from "@mozilla/readability";
-import TurndownService from "turndown";
-import turndownPluginGfm from "turndown-plugin-gfm";
+import { Defuddle } from "defuddle/node";
+import { withMockConsole } from "../util.js";
 import { escapeAppleScript, executeAppleScript, separator, } from "./osascript.js";
 async function getChromeTabList(applicationName) {
     const sep = separator();
@@ -82,23 +80,23 @@ async function getPageContent(applicationName, tab) {
         return "ERROR" & "${sep}" & errMsg
       end try
     `;
-    const result = await executeAppleScript(appleScript);
-    if (result.startsWith(`ERROR${sep}`))
-        throw new Error(result.split(sep)[1]);
-    const parts = result.split(sep).map((part) => part.trim());
-    if (parts.length < 3)
+    const scriptResult = await executeAppleScript(appleScript);
+    if (scriptResult.startsWith(`ERROR${sep}`)) {
+        throw new Error(scriptResult.split(sep)[1]);
+    }
+    const parts = scriptResult.split(sep).map((part) => part.trim());
+    if (parts.length < 3) {
         throw new Error("Failed to read the tab content");
+    }
     const [title, url, content] = parts;
-    const dom = new JSDOM(content, { url });
-    const reader = new Readability(dom.window.document, {
-        charThreshold: 10,
-    });
-    const article = reader.parse();
-    if (!article?.content)
+    // Suppress defuddle's console.log output during parsing
+    const { result: defuddleResult } = await withMockConsole(() => Defuddle(content, url, {
+        markdown: true,
+    }));
+    if (!defuddleResult?.content) {
         throw new Error("Failed to parse the page content");
-    const turndownService = new TurndownService();
-    turndownService.use(turndownPluginGfm.gfm);
-    const md = turndownService.turndown(article.content);
+    }
+    const md = defuddleResult.content;
     return {
         title,
         url,

package/dist/browser/osascript.js

@@ -2,6 +2,7 @@ import { execFile } from "child_process";
 import { promisify } from "util";
 const execFileAsync = promisify(execFile);
 export function escapeAppleScript(str) {
+    // https://discussions.apple.com/thread/4247426?sortBy=rank
     return str
         .replace(/\\/g, "\\\\")
         .replace(/"/g, '\\"')
@@ -9,7 +10,7 @@ export function escapeAppleScript(str) {
         .replace(/\r/g, "\\r");
 }
 export async function retry(fn, options) {
-    const { maxRetries = 2, retryDelay = 1000 } = options || {};
+    const { maxRetries = 1, retryDelay = 1000 } = options || {};
     for (let attempt = 0; attempt <= maxRetries; attempt++) {
         try {
             return await fn();

package/dist/browser/safari.js

@@ -1,7 +1,5 @@
-import { JSDOM } from "jsdom";
-import { Readability } from "@mozilla/readability";
-import TurndownService from "turndown";
-import turndownPluginGfm from "turndown-plugin-gfm";
+import { Defuddle } from "defuddle/node";
+import { withMockConsole } from "../util.js";
 import { escapeAppleScript, executeAppleScript, separator, } from "./osascript.js";
 async function getSafariTabList(applicationName) {
     const sep = separator();
@@ -82,23 +80,23 @@ async function getPageContent(applicationName, tab) {
         return "ERROR" & "${sep}" & errMsg
       end try
     `;
-    const result = await executeAppleScript(appleScript);
-    if (result.startsWith(`ERROR${sep}`))
-        throw new Error(result.split(sep)[1]);
-    const parts = result.split(sep).map((part) => part.trim());
-    if (parts.length < 3)
+    const scriptResult = await executeAppleScript(appleScript);
+    if (scriptResult.startsWith(`ERROR${sep}`)) {
+        throw new Error(scriptResult.split(sep)[1]);
+    }
+    const parts = scriptResult.split(sep).map((part) => part.trim());
+    if (parts.length < 3) {
         throw new Error("Failed to read the tab content");
+    }
     const [title, url, content] = parts;
-    const dom = new JSDOM(content, { url });
-    const reader = new Readability(dom.window.document, {
-        charThreshold: 10,
-    });
-    const article = reader.parse();
-    if (!article?.content)
+    // Suppress defuddle's console.log output during parsing
+    const { result: defuddleResult } = await withMockConsole(() => Defuddle(content, url, {
+        markdown: true,
+    }));
+    if (!defuddleResult?.content) {
         throw new Error("Failed to parse the page content");
-    const turndownService = new TurndownService();
-    turndownService.use(turndownPluginGfm.gfm);
-    const md = turndownService.turndown(article.content);
+    }
+    const md = defuddleResult.content;
     return {
         title,
         url,

package/dist/cli.js

@@ -94,11 +94,21 @@ function parseCliArgs(args) {
     };
     return parsed;
 }
-const options = parseCliArgs(process.argv.slice(2));
-if (options.help) {
-    showHelp();
-    process.exit(0);
+async function main() {
+    const options = parseCliArgs(process.argv.slice(2));
+    if (options.help) {
+        showHelp();
+        process.exit(0);
+    }
+    const server = await createMcpServer(options);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    const shutdown = async () => {
+        await transport.close();
+        await server.close();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
 }
-const server = await createMcpServer(options);
-const transport = new StdioServerTransport();
-await server.connect(transport);
+await main().catch(console.error);

package/dist/util.d.ts

@@ -0,0 +1,4 @@
+export declare function withMockConsole<T>(fn: () => Promise<T>): Promise<{
+    result: T;
+    logs: unknown[][];
+}>;

package/dist/util.js

@@ -0,0 +1,14 @@
+export async function withMockConsole(fn) {
+    const originalConsoleLog = console.log;
+    const logs = [];
+    console.log = (...args) => {
+        logs.push(args);
+    };
+    try {
+        const result = await fn();
+        return { result, logs };
+    }
+    finally {
+        console.log = originalConsoleLog;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pokutuna/mcp-chrome-tabs",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/pokutuna/mcp-chrome-tabs"
@@ -23,21 +23,20 @@
     "lint:fix": "prettier --write .",
     "prepublishOnly": "npm run build",
     "start": "node dist/index.js",
-    "test": "vitest",
-    "test:run": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "playwright test"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.16.0",
-    "@mozilla/readability": "^0.6.0",
-    "jsdom": "^26.1.0",
-    "turndown": "^7.2.0",
-    "turndown-plugin-gfm": "^1.0.2",
+    "defuddle": "^0.6.4",
+    "jsdom": "^24.0.0",
     "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@types/jsdom": "^21.1.7",
+    "@playwright/test": "^1.54.1",
     "@types/node": "^20.11.17",
-    "@types/turndown": "^5.0.5",
+    "playwright": "^1.54.1",
     "prettier": "^3.6.2",
     "tsx": "^4.7.1",
     "typescript": "~5.8.3",