stupidmirror-mcp 0.0.0-stage → 0.8.6

package/README.md

@@ -1,3 +1,35 @@
-# Temporary Holding Version
+# stupidmirror-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+MCP server launcher for [StupidMirror](https://github.com/LiuTianjie/StupidMirror), a macOS app that mirrors and controls iPhone and Android devices, iOS Simulators and Android emulators.
+
+**The StupidMirror macOS app is required.** This package contains no device code. It starts the MCP bridge that ships inside the app (`StupidMirror.app/Contents/Helpers/StupidMirrorMCPBridge`) over stdio. Without the app it prints an error and exits.
+
+## What the tools do
+
+List devices, read the screen (screenshot and local OCR), read the UI tree, tap, swipe, type, press buttons, open URLs, launch, install and uninstall apps, and record the screen.
+
+One device at a time is free. Several devices at once need an iTool yearly membership.
+
+## Setup
+
+1. Install StupidMirror from [GitHub Releases](https://github.com/LiuTianjie/StupidMirror/releases/latest) into `/Applications`.
+2. Open the app and enable **Settings > MCP**.
+3. Add the server to your MCP client:
+
+```json
+{
+  "mcpServers": {
+    "stupidmirror": { "command": "npx", "args": ["-y", "stupidmirror-mcp"] }
+  }
+}
+```
+
+If the app is somewhere other than `/Applications/StupidMirror.app`, set `STUPIDMIRROR_APP` to its path.
+
+The app can also register itself with Claude Code and Codex from **Settings > MCP Automation**.
+
+More: https://stupidmirror.itool.tech/mcp/
+
+## License
+
+[PolyForm Noncommercial 1.0.0](https://github.com/LiuTianjie/StupidMirror/blob/main/LICENSE), same as StupidMirror.

package/bin/stupidmirror-mcp.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+"use strict";
+// Starts the MCP bridge bundled in the StupidMirror macOS app over stdio.
+const { spawn } = require("child_process");
+const fs = require("fs");
+
+const app = process.env.STUPIDMIRROR_APP || "/Applications/StupidMirror.app";
+const bridge = app + "/Contents/Helpers/StupidMirrorMCPBridge";
+
+if (process.platform !== "darwin" || !fs.existsSync(bridge)) {
+  process.stderr.write(
+    "stupidmirror-mcp: StupidMirror.app was not found at " + app + ".\n" +
+    "This package only launches the MCP bridge inside the StupidMirror macOS app.\n" +
+    "Install the app from https://github.com/LiuTianjie/StupidMirror/releases/latest\n" +
+    "(or set STUPIDMIRROR_APP to its path), then enable Settings > MCP in the app.\n"
+  );
+  process.exit(1);
+}
+
+const child = spawn(bridge, ["--app", app, ...process.argv.slice(2)], { stdio: "inherit" });
+for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) process.on(sig, () => child.kill(sig));
+child.on("error", (err) => { process.stderr.write("stupidmirror-mcp: " + err.message + "\n"); process.exit(1); });
+child.on("exit", (code, signal) => process.exit(signal ? 1 : code ?? 0));

package/package.json

@@ -1,6 +1,15 @@
 {
   "name": "stupidmirror-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.8.6",
+  "description": "MCP stdio launcher for the StupidMirror macOS app: operate iPhone/Android devices, iOS Simulators and Android emulators.",
+  "mcpName": "io.github.LiuTianjie/stupidmirror",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "bin": { "stupidmirror-mcp": "bin/stupidmirror-mcp.js" },
+  "files": ["bin/", "README.md"],
+  "os": ["darwin"],
+  "engines": { "node": ">=18" },
+  "homepage": "https://stupidmirror.itool.tech/mcp/",
+  "repository": { "type": "git", "url": "git+https://github.com/LiuTianjie/StupidMirror.git" },
+  "bugs": { "url": "https://github.com/LiuTianjie/StupidMirror/issues" },
+  "keywords": ["mcp", "model-context-protocol", "ios", "android", "iphone", "simulator", "emulator", "automation", "stupidmirror"]
+}