safari-mcp 2.7.16 → 2.8.1

package/README.md

@@ -13,6 +13,10 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![macOS](https://img.shields.io/badge/macOS-only-blue)](https://www.apple.com/macos/)
 [![GitHub stars](https://img.shields.io/github/stars/achiya-automation/safari-mcp?style=social)](https://github.com/achiya-automation/safari-mcp/stargazers)
+
+[![MCP Registry](https://img.shields.io/badge/MCP-Registry-purple?logo=anthropic)](https://registry.modelcontextprotocol.io/)
+[![Glama](https://img.shields.io/badge/Glama-Listed-7c3aed)](https://glama.ai/mcp/servers/g0upg7gyex)
+[![Awesome MCP](https://img.shields.io/badge/Awesome%20MCP-Featured-ff69b4)](https://github.com/punkpeye/awesome-mcp-servers)
 [![Featured in CLI-Anything](https://img.shields.io/badge/Featured%20in-CLI--Anything-blueviolet)](https://github.com/HKUDS/CLI-Anything/pull/212)
 
 <a href="vscode:mcp/install?%7B%22safari-mcp%22%3A%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22safari-mcp%22%5D%7D%7D"><img src="https://img.shields.io/badge/VS_Code-Install_Server-0078d4?logo=visual-studio-code&logoColor=white" alt="Install in VS Code"></a>
@@ -121,6 +125,21 @@ cd safari-mcp && npm install
 
 ---
 
+<div align="center">
+
+### ⭐ Found Safari MCP useful?
+
+**A star takes 2 seconds and helps other macOS developers discover this.**
+
+[![Star on GitHub](https://img.shields.io/github/stars/achiya-automation/safari-mcp?style=for-the-badge&logo=github&color=yellow&label=Star%20this%20repo)](https://github.com/achiya-automation/safari-mcp)
+
+*4,000+ developers install Safari MCP every month. Less than 1% star it.*
+*If it saves you Chrome heat, give it back a click.*
+
+</div>
+
+---
+
 ## Usage Workflow
 
 The recommended pattern for AI agents using Safari MCP:
@@ -351,22 +370,32 @@ Safari MCP runs locally on your Mac with minimal attack surface:
 
 > **Tip:** Use Safari MCP for daily browsing tasks (95% of work) and Chrome DevTools MCP only for Lighthouse/Performance audits.
 
-### Safari MCP Servers Comparison
-
-| Feature | **safari-mcp** | MCPSafari | safari-mcp-server |
-|---------|:--------------:|:---------:|:-----------------:|
-| Tools | **80** | 23 | ~10 |
-| License | **MIT** | None | MIT |
-| Install | npm / Homebrew | Binary | npm |
-| Storage (cookies, localStorage) | **10 tools** | None | None |
-| Data extraction (tables, links) | **5 tools** | None | None |
-| Network mocking | **Yes** | No | No |
-| Device emulation | **Yes** | No | No |
-| File upload (no dialog) | **Yes** | No | No |
-| PDF export | **Yes** | No | No |
-| Console capture | **4 tools** | 1 | No |
-| Performance metrics | **Yes** | No | No |
-| Fallback engine | **Dual (Extension + AppleScript)** | Extension only | WebDriver |
+### Why Safari MCP and Not the Other Safari MCP Projects?
+
+There are several "safari-mcp" projects floating around. Here's how they compare:
+
+| Feature | **🦁 safari-mcp** *(this repo)* | [lxman/safari-mcp-server](https://github.com/lxman/safari-mcp-server) | [Epistates/MCPSafari](https://github.com/Epistates/MCPSafari) | [HayoDev/safari-devtools-mcp](https://github.com/HayoDev/safari-devtools-mcp) |
+|---------|:------------------------------:|:----------------------:|:------------:|:----------------------:|
+| **Tools** | **80** | ~10 | 23 | ~15 |
+| **Install** | `npx safari-mcp` | Manual | Binary | `npx` |
+| **Engine** | **Dual** (Extension + AppleScript) | WebDriver | Extension only | DevTools Protocol |
+| **Keeps your real Safari logins** | ✅ Yes | ⚠️ Limited | ✅ Yes | ❌ Debug session |
+| **Background (no focus steal)** | ✅ Yes | ❌ No | ⚠️ Sometimes | ✅ Yes |
+| **Storage tools** (cookies, localStorage, IndexedDB) | **10** | 0 | 0 | 2 |
+| **Data extraction** (tables, meta, images, links) | **4** | 0 | 0 | 0 |
+| **Network mocking** | ✅ Yes | ❌ No | ❌ No | ❌ No |
+| **Device emulation** (iPhone, iPad, Pixel) | ✅ Yes | ❌ No | ❌ No | ❌ No |
+| **File upload** (no dialog) | ✅ JS DataTransfer | ❌ No | ❌ No | ❌ No |
+| **Image paste** (no clipboard touch) | ✅ Yes | ❌ No | ❌ No | ❌ No |
+| **PDF export** | ✅ Yes | ❌ No | ❌ No | ❌ No |
+| **Console capture** | **4 tools** | 0 | 1 | 1 |
+| **Performance metrics + Web Vitals** | ✅ Yes | ❌ No | ❌ No | ⚠️ Partial |
+| **Active maintenance** | ✅ Multiple releases/week | 🟡 Sporadic | 🟡 Slow | 🟡 Slow |
+| **License** | **MIT** | MIT | None specified | MIT |
+| **In MCP Registry** | ✅ | ❌ | ❌ | ✅ |
+| **In Awesome MCP** | ✅ | ❌ | ❌ | ❌ |
+
+> **TL;DR** — if you want the most complete Safari MCP with the smoothest install, the most tools, and active maintenance, **this is the one**.
 
 ---
 
@@ -552,6 +581,19 @@ Your support funds:
 
 ---
 
+## Ecosystem
+
+Other macOS MCP servers that complement Safari MCP:
+
+| Project | What it does | When to use |
+|---------|-------------|-------------|
+| [mcp-server-macos-use](https://github.com/mediar-ai/mcp-server-macos-use) | OS-level macOS automation (accessibility, screen control) | System-wide interactions beyond Safari |
+| [chrome-devtools-mcp](https://github.com/anthropics/chrome-devtools-mcp) | Chrome DevTools Protocol | Lighthouse audits, Chrome-specific performance traces |
+
+> Using Safari MCP alongside Chrome DevTools MCP? Safari handles 95% of daily browsing (zero overhead), Chrome handles the 5% that needs Lighthouse or Chrome-specific traces.
+
+---
+
 ## Like it? Give it a ⭐
 
 If Safari MCP saves you from Chrome overhead, **a star helps others discover it:**

package/index.js

@@ -2159,6 +2159,28 @@ server.tool(
 
 // ========== START SERVER ==========
 
+// One-time-per-day startup banner — visible CTA without spamming MCP logs.
+// Stderr only (stdout is reserved for MCP protocol). Skipped if SAFARI_MCP_QUIET=1.
+try {
+  if (process.env.SAFARI_MCP_QUIET !== "1") {
+    const bannerStateFile = join(homedir(), ".safari-mcp", "last-banner");
+    if (!existsSync(OWNERSHIP_DIR)) mkdirSync(OWNERSHIP_DIR, { recursive: true });
+    let lastShown = 0;
+    try { lastShown = parseInt(readFileSync(bannerStateFile, "utf8"), 10) || 0; } catch {}
+    const ONE_DAY_MS = 24 * 60 * 60 * 1000;
+    if (Date.now() - lastShown > ONE_DAY_MS) {
+      const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "package.json");
+      let version = "?";
+      try { version = JSON.parse(readFileSync(pkgPath, "utf8")).version; } catch {}
+      console.error("");
+      console.error(`[Safari MCP] 🦁 v${version} ready — 80 tools, native WebKit, zero Chrome.`);
+      console.error(`[Safari MCP] ⭐ Like it? Star: https://github.com/achiya-automation/safari-mcp`);
+      console.error("");
+      try { writeFileSync(bannerStateFile, String(Date.now()), { mode: 0o600 }); } catch {}
+    }
+  }
+} catch { /* banner is best-effort, never block startup */ }
+
 _startMemoryMonitor();
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "safari-mcp",
-  "version": "2.7.16",
+  "version": "2.8.1",
   "mcpName": "io.github.achiya-automation/safari-mcp",
   "description": "Safari browser automation for AI agents — native macOS, zero Chrome overhead. 80 tools via AppleScript + JavaScript.",
   "type": "module",
@@ -10,7 +10,8 @@
     "safari-mcp": "index.js"
   },
   "scripts": {
-    "start": "node index.js"
+    "start": "node index.js",
+    "postinstall": "node scripts/postinstall.cjs || true"
   },
   "keywords": [
     "safari",
@@ -67,7 +68,8 @@
     "glama.json",
     "LICENSE",
     "README.md",
-    "index.d.ts"
+    "index.d.ts",
+    "scripts/postinstall.cjs"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",

package/scripts/postinstall.cjs

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+// Safari MCP — postinstall welcome message
+// Skipped silently in CI and when stdout is not a TTY (npm install in scripts).
+
+if (process.env.CI || process.env.SAFARI_MCP_SILENT_INSTALL === "1") process.exit(0);
+
+const c = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  cyan: "\x1b[36m",
+  yellow: "\x1b[33m",
+  magenta: "\x1b[35m",
+  green: "\x1b[32m",
+};
+
+const msg = `
+${c.bold}${c.cyan}🦁 Safari MCP installed${c.reset} ${c.dim}— 80 native browser tools for AI agents${c.reset}
+
+${c.bold}Next steps:${c.reset}
+  1. Enable Safari → Develop → ${c.yellow}Allow JavaScript from Apple Events${c.reset}
+  2. Add to your MCP client config:
+     ${c.dim}{ "mcpServers": { "safari": { "command": "npx", "args": ["safari-mcp"] } } }${c.reset}
+
+${c.bold}${c.magenta}⭐ Found this useful?${c.reset} A star helps others discover it:
+   ${c.cyan}https://github.com/achiya-automation/safari-mcp${c.reset}
+
+${c.dim}Docs · Examples · Issues → github.com/achiya-automation/safari-mcp${c.reset}
+`;
+
+try { process.stdout.write(msg); } catch { /* ignore */ }