@tmhs/mobile-mcp 0.11.0 → 0.12.0

package/dist/index.js

@@ -34,9 +34,12 @@ import { register as registerSetupMonitoring } from "./tools/setupMonitoring.js"
 import { register as registerSetupTheming } from "./tools/setupTheming.js";
 import { register as registerAuditAccessibility } from "./tools/auditAccessibility.js";
 import { register as registerSetupFeatureFlags } from "./tools/setupFeatureFlags.js";
+import { register as registerCreateNativeModule } from "./tools/createNativeModule.js";
+import { register as registerUpgradeSDK } from "./tools/upgradeSDK.js";
+import { register as registerCheckNativeCompat } from "./tools/checkNativeCompat.js";
 const server = new McpServer({
     name: "mobile-mcp",
-    version: "0.11.0",
+    version: "0.12.0",
 });
 registerCheckDevEnvironment(server);
 registerScaffoldProject(server);
@@ -71,6 +74,9 @@ registerSetupMonitoring(server);
 registerSetupTheming(server);
 registerAuditAccessibility(server);
 registerSetupFeatureFlags(server);
+registerCreateNativeModule(server);
+registerUpgradeSDK(server);
+registerCheckNativeCompat(server);
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAE,QAAQ,IAAI,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,QAAQ,IAAI,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,QAAQ,IAAI,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,QAAQ,IAAI,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC3F,OAAO,EAAE,QAAQ,IAAI,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,IAAI,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAC7F,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,QAAQ,IAAI,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,IAAI,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,IAAI,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,QAAQ,IAAI,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,QAAQ,IAAI,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,IAAI,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAErF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,QAAQ;CAClB,CAAC,CAAC;AAEH,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACpC,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,4BAA4B,CAAC,MAAM,CAAC,CAAC;AACrC,0BAA0B,CAAC,MAAM,CAAC,CAAC;AACnC,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACpC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,6BAA6B,CAAC,MAAM,CAAC,CAAC;AACtC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACpC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,eAAe,CAAC,MAAM,CAAC,CAAC;AACxB,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,cAAc,CAAC,MAAM,CAAC,CAAC;AACvB,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,0BAA0B,CAAC,MAAM,CAAC,CAAC;AACnC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,0BAA0B,CAAC,MAAM,CAAC,CAAC;AACnC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAElC,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/checkNativeCompat.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=checkNativeCompat.d.ts.map

package/dist/tools/checkNativeCompat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkNativeCompat.d.ts","sourceRoot":"","sources":["../../src/tools/checkNativeCompat.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuPzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0ChD"}

package/dist/tools/checkNativeCompat.js

@@ -0,0 +1,255 @@
+import { z } from "zod";
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { textResponse, errorResponse } from "../types.js";
+const inputSchema = {
+    project_path: z
+        .string()
+        .optional()
+        .describe("Absolute path to the project root. Defaults to cwd."),
+    framework: z
+        .enum(["expo", "flutter"])
+        .optional()
+        .default("expo")
+        .describe("Framework (default: expo)."),
+};
+const KNOWN_BRIDGE_ONLY_PACKAGES = new Set([
+    "react-native-camera",
+    "react-native-image-picker",
+    "react-native-video",
+    "react-native-fbsdk",
+    "react-native-firebase",
+    "react-native-push-notification",
+    "react-native-sound",
+    "react-native-background-geolocation",
+    "@react-native-community/netinfo",
+    "react-native-bluetooth-serial",
+]);
+const DEPRECATED_PACKAGES = {
+    "react-native-camera": "expo-camera or react-native-vision-camera",
+    "react-native-image-picker": "expo-image-picker or react-native-image-picker@5+",
+    "react-native-fbsdk": "@react-native-fbsdk-next/fbsdk-next",
+    "react-native-push-notification": "expo-notifications or @notifee/react-native",
+    "react-native-sound": "expo-av or react-native-track-player",
+    "@react-native-community/netinfo": "@react-native-community/netinfo@11+ (New Arch support)",
+    "react-native-navigation": "expo-router or @react-navigation/native@7+",
+    "react-native-vector-icons": "@expo/vector-icons (Expo) or react-native-vector-icons@10+",
+};
+const NEW_ARCH_READY_PACKAGES = new Set([
+    "react-native-reanimated",
+    "react-native-gesture-handler",
+    "react-native-screens",
+    "react-native-safe-area-context",
+    "@react-native-async-storage/async-storage",
+    "react-native-svg",
+    "react-native-webview",
+    "react-native-maps",
+    "@react-native-community/datetimepicker",
+    "react-native-pager-view",
+    "react-native-vision-camera",
+    "expo-camera",
+    "expo-location",
+    "expo-notifications",
+    "expo-file-system",
+    "expo-image-picker",
+    "expo-av",
+    "expo-haptics",
+    "expo-secure-store",
+    "expo-sqlite",
+]);
+function auditExpoProject(root) {
+    const issues = [];
+    const pkgPath = join(root, "package.json");
+    if (!existsSync(pkgPath)) {
+        issues.push({
+            severity: "critical",
+            package_name: "package.json",
+            message: "No package.json found at project root.",
+            recommendation: "Ensure you are pointing to the correct project directory.",
+        });
+        return issues;
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    }
+    catch {
+        issues.push({
+            severity: "critical",
+            package_name: "package.json",
+            message: "Failed to parse package.json.",
+            recommendation: "Fix JSON syntax errors in package.json.",
+        });
+        return issues;
+    }
+    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+    for (const [name, version] of Object.entries(allDeps)) {
+        if (DEPRECATED_PACKAGES[name]) {
+            issues.push({
+                severity: "critical",
+                package_name: name,
+                message: `Deprecated package. Use ${DEPRECATED_PACKAGES[name]} instead.`,
+                recommendation: `Replace ${name} with ${DEPRECATED_PACKAGES[name]} for New Architecture support.`,
+            });
+        }
+        else if (KNOWN_BRIDGE_ONLY_PACKAGES.has(name)) {
+            issues.push({
+                severity: "warning",
+                package_name: name,
+                message: "This package may not support the New Architecture (Fabric/TurboModules).",
+                recommendation: "Check the package README for New Architecture support or find an alternative.",
+            });
+        }
+        if (name.startsWith("react-native-") && !name.startsWith("@") && !NEW_ARCH_READY_PACKAGES.has(name)) {
+            const isKnownIssue = DEPRECATED_PACKAGES[name] || KNOWN_BRIDGE_ONLY_PACKAGES.has(name);
+            if (!isKnownIssue) {
+                issues.push({
+                    severity: "info",
+                    package_name: name,
+                    message: "Unverified New Architecture compatibility. Check package docs.",
+                    recommendation: `Verify ${name} supports Fabric/TurboModules before enabling New Architecture.`,
+                });
+            }
+        }
+    }
+    const appJsonPath = join(root, "app.json");
+    if (existsSync(appJsonPath)) {
+        try {
+            const appJson = JSON.parse(readFileSync(appJsonPath, "utf-8"));
+            const newArchEnabled = appJson?.expo?.newArchEnabled;
+            if (newArchEnabled === undefined) {
+                issues.push({
+                    severity: "info",
+                    package_name: "app.json",
+                    message: 'New Architecture not explicitly configured. Set "newArchEnabled" in app.json.',
+                    recommendation: 'Add "newArchEnabled": true under expo key to enable Fabric and TurboModules.',
+                });
+            }
+        }
+        catch { /* skip parse errors */ }
+    }
+    if (issues.length === 0) {
+        issues.push({
+            severity: "info",
+            package_name: "project",
+            message: "No known compatibility issues detected. All checked packages appear New Architecture ready.",
+            recommendation: "Enable New Architecture in app.json and test thoroughly on both platforms.",
+        });
+    }
+    return issues;
+}
+function auditFlutterProject(root) {
+    const issues = [];
+    const pubspecPath = join(root, "pubspec.yaml");
+    if (!existsSync(pubspecPath)) {
+        issues.push({
+            severity: "critical",
+            package_name: "pubspec.yaml",
+            message: "No pubspec.yaml found at project root.",
+            recommendation: "Ensure you are pointing to the correct Flutter project directory.",
+        });
+        return issues;
+    }
+    let content;
+    try {
+        content = readFileSync(pubspecPath, "utf-8");
+    }
+    catch {
+        issues.push({
+            severity: "critical",
+            package_name: "pubspec.yaml",
+            message: "Failed to read pubspec.yaml.",
+            recommendation: "Check file permissions.",
+        });
+        return issues;
+    }
+    const sdkMatch = content.match(/sdk:\s*['"]?>=?\s*([\d.]+)/);
+    if (sdkMatch) {
+        const minSdk = sdkMatch[1];
+        const parts = minSdk.split(".").map(Number);
+        if (parts[0] < 3) {
+            issues.push({
+                severity: "critical",
+                package_name: "dart-sdk",
+                message: `Dart SDK constraint starts at ${minSdk}. Dart 3+ is required for modern Flutter.`,
+                recommendation: "Update sdk constraint to >=3.0.0 in pubspec.yaml.",
+            });
+        }
+    }
+    const androidDir = join(root, "android");
+    if (existsSync(androidDir)) {
+        const buildGradlePath = join(androidDir, "app", "build.gradle");
+        if (existsSync(buildGradlePath)) {
+            try {
+                const gradle = readFileSync(buildGradlePath, "utf-8");
+                const minSdkMatch = gradle.match(/minSdkVersion\s+(\d+)/);
+                if (minSdkMatch && parseInt(minSdkMatch[1], 10) < 21) {
+                    issues.push({
+                        severity: "warning",
+                        package_name: "android/app/build.gradle",
+                        message: `minSdkVersion ${minSdkMatch[1]} is below 21. Most modern packages require 21+.`,
+                        recommendation: "Update minSdkVersion to at least 21 (or 23 for best compatibility).",
+                    });
+                }
+            }
+            catch { /* skip */ }
+        }
+    }
+    const deprecatedFlutterPackages = {
+        "flutter_webview_plugin": "webview_flutter",
+        "flutter_calendar_carousel": "table_calendar",
+        "flutter_slidable": "flutter_slidable@3+ (check API migration)",
+        "cached_network_image": "cached_network_image@3+ (null safety)",
+        "sqflite": "drift or sqflite@2+ (null safety)",
+    };
+    for (const [name, replacement] of Object.entries(deprecatedFlutterPackages)) {
+        if (content.includes(name + ":")) {
+            issues.push({
+                severity: "warning",
+                package_name: name,
+                message: `Consider upgrading or replacing with ${replacement}.`,
+                recommendation: `Migrate from ${name} to ${replacement} for better compatibility.`,
+            });
+        }
+    }
+    if (issues.length === 0) {
+        issues.push({
+            severity: "info",
+            package_name: "project",
+            message: "No known compatibility issues detected.",
+            recommendation: "Run flutter analyze and flutter test to verify full compatibility.",
+        });
+    }
+    return issues;
+}
+export function register(server) {
+    server.tool("mobile_checkNativeCompat", "Audit installed packages for New Architecture (Fabric/TurboModules) support. Flag bridge-only dependencies, deprecated native APIs, and packages without JSI support.", inputSchema, async (args) => {
+        try {
+            const root = args.project_path || process.cwd();
+            if (!existsSync(root)) {
+                return errorResponse(new Error(`Project path does not exist: ${root}`));
+            }
+            const issues = args.framework === "flutter"
+                ? auditFlutterProject(root)
+                : auditExpoProject(root);
+            const criticalCount = issues.filter((i) => i.severity === "critical").length;
+            const warningCount = issues.filter((i) => i.severity === "warning").length;
+            const infoCount = issues.filter((i) => i.severity === "info").length;
+            return textResponse(JSON.stringify({
+                success: true,
+                framework: args.framework,
+                summary: {
+                    total_issues: issues.length,
+                    critical: criticalCount,
+                    warnings: warningCount,
+                    info: infoCount,
+                },
+                issues,
+            }, null, 2));
+        }
+        catch (err) {
+            return errorResponse(err);
+        }
+    });
+}
+//# sourceMappingURL=checkNativeCompat.js.map

package/dist/tools/checkNativeCompat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkNativeCompat.js","sourceRoot":"","sources":["../../src/tools/checkNativeCompat.ts"],"names":[],"mappings":"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"}

package/dist/tools/createNativeModule.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=createNativeModule.d.ts.map

package/dist/tools/createNativeModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNativeModule.d.ts","sourceRoot":"","sources":["../../src/tools/createNativeModule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkOzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4FhD"}

package/dist/tools/createNativeModule.js

@@ -0,0 +1,291 @@
+import { z } from "zod";
+import { writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { textResponse, errorResponse } from "../types.js";
+const inputSchema = {
+    project_path: z
+        .string()
+        .optional()
+        .describe("Absolute path to the project root. Defaults to cwd."),
+    framework: z
+        .enum(["expo", "flutter"])
+        .optional()
+        .default("expo")
+        .describe("Framework (default: expo)."),
+    module_name: z
+        .string()
+        .describe("Name of the native module (PascalCase, e.g. 'Haptics')."),
+    output_directory: z
+        .string()
+        .optional()
+        .default("modules")
+        .describe("Output directory relative to project root (default: modules)."),
+};
+function toPascalCase(name) {
+    return name.charAt(0).toUpperCase() + name.slice(1);
+}
+function toKebabCase(name) {
+    return name.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+function generateExpoModuleIndex(name) {
+    return `import ${name}Module from "./${name}Module";
+
+export function hello(): string {
+  return ${name}Module.hello();
+}
+
+export function multiply(a: number, b: number): number {
+  return ${name}Module.multiply(a, b);
+}
+`;
+}
+function generateExpoModuleNative(name) {
+    return `import { requireNativeModule } from "expo-modules-core";
+
+const ${name}Module = requireNativeModule("${name}");
+
+export default ${name}Module;
+`;
+}
+function generateExpoModuleConfig(name) {
+    return `{
+  "name": "${name}",
+  "platforms": ["ios", "android"],
+  "ios": {
+    "modules": ["${name}Module"]
+  },
+  "android": {
+    "modules": ["${name}Module"]
+  }
+}
+`;
+}
+function generateSwiftModule(name) {
+    return `import ExpoModulesCore
+
+public class ${name}Module: Module {
+  public func definition() -> ModuleDefinition {
+    Name("${name}")
+
+    Function("hello") {
+      return "Hello from ${name} native module!"
+    }
+
+    Function("multiply") { (a: Double, b: Double) -> Double in
+      return a * b
+    }
+  }
+}
+`;
+}
+function generateKotlinModule(name) {
+    const pkg = `expo.modules.${name.toLowerCase()}`;
+    return `package ${pkg}
+
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+class ${name}Module : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("${name}")
+
+    Function("hello") {
+      "Hello from ${name} native module!"
+    }
+
+    Function("multiply") { a: Double, b: Double ->
+      a * b
+    }
+  }
+}
+`;
+}
+function generateFlutterPluginDart(name) {
+    const snakeName = toKebabCase(name).replace(/-/g, "_");
+    return `import 'dart:async';
+import 'package:flutter/services.dart';
+
+class ${name} {
+  static const MethodChannel _channel = MethodChannel('${snakeName}');
+
+  static Future<String> hello() async {
+    final result = await _channel.invokeMethod<String>('hello');
+    return result ?? '';
+  }
+
+  static Future<double> multiply(double a, double b) async {
+    final result = await _channel.invokeMethod<double>('multiply', {
+      'a': a,
+      'b': b,
+    });
+    return result ?? 0;
+  }
+}
+`;
+}
+function generateFlutterPlatformInterface(name) {
+    const snakeName = toKebabCase(name).replace(/-/g, "_");
+    return `import 'package:flutter/services.dart';
+
+class ${name}Platform {
+  static const MethodChannel _channel = MethodChannel('${snakeName}');
+
+  Future<String> hello() async {
+    final result = await _channel.invokeMethod<String>('hello');
+    return result ?? '';
+  }
+
+  Future<double> multiply(double a, double b) async {
+    final result = await _channel.invokeMethod<double>('multiply', {
+      'a': a,
+      'b': b,
+    });
+    return result ?? 0;
+  }
+}
+`;
+}
+function generateSwiftPlugin(name) {
+    const snakeName = toKebabCase(name).replace(/-/g, "_");
+    return `import Flutter
+import UIKit
+
+public class ${name}Plugin: NSObject, FlutterPlugin {
+  public static func register(with registrar: FlutterPluginRegistrar) {
+    let channel = FlutterMethodChannel(
+      name: "${snakeName}",
+      binaryMessenger: registrar.messenger()
+    )
+    let instance = ${name}Plugin()
+    registrar.addMethodCallDelegate(instance, channel: channel)
+  }
+
+  public func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
+    switch call.method {
+    case "hello":
+      result("Hello from ${name} native module!")
+    case "multiply":
+      guard let args = call.arguments as? [String: Any],
+            let a = args["a"] as? Double,
+            let b = args["b"] as? Double else {
+        result(FlutterError(code: "INVALID_ARGS", message: "Expected a and b", details: nil))
+        return
+      }
+      result(a * b)
+    default:
+      result(FlutterMethodNotImplemented)
+    }
+  }
+}
+`;
+}
+function generateKotlinPlugin(name) {
+    const snakeName = toKebabCase(name).replace(/-/g, "_");
+    return `package com.example.${snakeName}
+
+import io.flutter.embedding.engine.plugins.FlutterPlugin
+import io.flutter.plugin.common.MethodCall
+import io.flutter.plugin.common.MethodChannel
+
+class ${name}Plugin : FlutterPlugin, MethodChannel.MethodCallHandler {
+  private lateinit var channel: MethodChannel
+
+  override fun onAttachedToEngine(binding: FlutterPlugin.FlutterPluginBinding) {
+    channel = MethodChannel(binding.binaryMessenger, "${snakeName}")
+    channel.setMethodCallHandler(this)
+  }
+
+  override fun onMethodCall(call: MethodCall, result: MethodChannel.Result) {
+    when (call.method) {
+      "hello" -> result.success("Hello from ${name} native module!")
+      "multiply" -> {
+        val a = call.argument<Double>("a") ?: return result.error("INVALID_ARGS", "Missing a", null)
+        val b = call.argument<Double>("b") ?: return result.error("INVALID_ARGS", "Missing b", null)
+        result.success(a * b)
+      }
+      else -> result.notImplemented()
+    }
+  }
+
+  override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) {
+    channel.setMethodCallHandler(null)
+  }
+}
+`;
+}
+export function register(server) {
+    server.tool("mobile_createNativeModule", "Scaffold an Expo Module or Flutter platform plugin with Swift/Kotlin stubs and TypeScript/Dart bindings.", inputSchema, async (args) => {
+        try {
+            const root = args.project_path || process.cwd();
+            const name = toPascalCase(args.module_name);
+            const kebab = toKebabCase(name);
+            const isFlutter = args.framework === "flutter";
+            const moduleDir = join(root, args.output_directory, kebab);
+            if (existsSync(moduleDir)) {
+                return errorResponse(new Error(`Module directory already exists: ${moduleDir}`));
+            }
+            const created = [];
+            if (isFlutter) {
+                const libDir = join(moduleDir, "lib");
+                const iosDir = join(moduleDir, "ios", "Classes");
+                const androidDir = join(moduleDir, "android", "src", "main", "kotlin", "com", "example", kebab.replace(/-/g, "_"));
+                mkdirSync(libDir, { recursive: true });
+                mkdirSync(iosDir, { recursive: true });
+                mkdirSync(androidDir, { recursive: true });
+                const files = [
+                    { path: join(libDir, `${kebab.replace(/-/g, "_")}.dart`), content: generateFlutterPluginDart(name) },
+                    { path: join(libDir, `${kebab.replace(/-/g, "_")}_platform.dart`), content: generateFlutterPlatformInterface(name) },
+                    { path: join(iosDir, `${name}Plugin.swift`), content: generateSwiftPlugin(name) },
+                    { path: join(androidDir, `${name}Plugin.kt`), content: generateKotlinPlugin(name) },
+                ];
+                for (const f of files) {
+                    writeFileSync(f.path, f.content, "utf-8");
+                    created.push(f.path);
+                }
+            }
+            else {
+                const srcDir = join(moduleDir, "src");
+                const iosDir = join(moduleDir, "ios");
+                const androidDir = join(moduleDir, "android", "src", "main", "java", "expo", "modules", name.toLowerCase());
+                mkdirSync(srcDir, { recursive: true });
+                mkdirSync(iosDir, { recursive: true });
+                mkdirSync(androidDir, { recursive: true });
+                const files = [
+                    { path: join(srcDir, "index.ts"), content: generateExpoModuleIndex(name) },
+                    { path: join(srcDir, `${name}Module.ts`), content: generateExpoModuleNative(name) },
+                    { path: join(moduleDir, "expo-module.config.json"), content: generateExpoModuleConfig(name) },
+                    { path: join(iosDir, `${name}Module.swift`), content: generateSwiftModule(name) },
+                    { path: join(androidDir, `${name}Module.kt`), content: generateKotlinModule(name) },
+                ];
+                for (const f of files) {
+                    writeFileSync(f.path, f.content, "utf-8");
+                    created.push(f.path);
+                }
+            }
+            const nextSteps = isFlutter
+                ? [
+                    `Add the plugin to pubspec.yaml as a path dependency: path: ${args.output_directory}/${kebab}`,
+                    "Run flutter pub get",
+                    "Import and call the module from Dart code",
+                    "Customize Swift and Kotlin implementations for your use case",
+                ]
+                : [
+                    `Import from "${args.output_directory}/${kebab}/src" in your app code`,
+                    "Run npx expo prebuild to generate native projects",
+                    "Customize the Swift and Kotlin Module definitions",
+                    "Add new native functions following the existing pattern",
+                ];
+            return textResponse(JSON.stringify({
+                success: true,
+                framework: args.framework,
+                module_name: name,
+                files_created: created,
+                next_steps: nextSteps,
+            }, null, 2));
+        }
+        catch (err) {
+            return errorResponse(err);
+        }
+    });
+}
+//# sourceMappingURL=createNativeModule.js.map

package/dist/tools/createNativeModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNativeModule.js","sourceRoot":"","sources":["../../src/tools/createNativeModule.ts"],"names":[],"mappings":"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"}

package/dist/tools/upgradeSDK.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=upgradeSDK.d.ts.map

package/dist/tools/upgradeSDK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgradeSDK.d.ts","sourceRoot":"","sources":["../../src/tools/upgradeSDK.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4JzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2BhD"}

package/dist/tools/upgradeSDK.js

@@ -0,0 +1,170 @@
+import { z } from "zod";
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+import { textResponse, errorResponse } from "../types.js";
+const inputSchema = {
+    project_path: z
+        .string()
+        .optional()
+        .describe("Absolute path to the project root. Defaults to cwd."),
+    framework: z
+        .enum(["expo", "flutter"])
+        .optional()
+        .default("expo")
+        .describe("Framework (default: expo)."),
+    target_version: z
+        .string()
+        .optional()
+        .describe("Target SDK version to upgrade to. If omitted, detects latest."),
+};
+function detectExpoVersion(root) {
+    const pkgPath = join(root, "package.json");
+    if (!existsSync(pkgPath))
+        return null;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        const expoVersion = pkg.dependencies?.expo || pkg.devDependencies?.expo;
+        if (!expoVersion)
+            return null;
+        return expoVersion.replace(/[\^~>=<]/g, "").trim();
+    }
+    catch {
+        return null;
+    }
+}
+function detectFlutterVersion(root) {
+    try {
+        const output = execSync("flutter --version --machine", {
+            cwd: root,
+            timeout: 15000,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const parsed = JSON.parse(output);
+        return parsed.frameworkVersion || null;
+    }
+    catch {
+        const pubspecPath = join(root, "pubspec.yaml");
+        if (!existsSync(pubspecPath))
+            return null;
+        try {
+            const content = readFileSync(pubspecPath, "utf-8");
+            const match = content.match(/sdk:\s*['"]?>=?\s*([\d.]+)/);
+            return match ? match[1] : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function getExpoUpgradeSteps(current, target) {
+    return {
+        framework: "expo",
+        current_version: current,
+        target_version: target || "latest",
+        pre_upgrade_checklist: [
+            "Commit all current changes to git (create a clean restore point)",
+            "Run existing tests and confirm they pass",
+            "Review CHANGELOG for target SDK version at expo.dev/changelog",
+            "Run npx expo-doctor to check current project health",
+            "Back up app.json / app.config.js",
+        ],
+        upgrade_steps: [
+            `Run: npx expo install expo@${target || "latest"} --fix`,
+            "Run: npx expo install --fix (updates all Expo packages to compatible versions)",
+            "Run: npx expo-doctor (check for remaining compatibility issues)",
+            "Update app.json sdkVersion if present",
+            "Run: npx expo prebuild --clean (regenerate native projects)",
+            "Run: npx expo start --clear (clear Metro cache)",
+            "Test on both iOS and Android simulators/devices",
+        ],
+        breaking_changes: [
+            "Check for deprecated APIs removed in the new SDK version",
+            "Review Expo Router version compatibility if using file-based routing",
+            "Check if any config plugins need updates for the new SDK",
+            "Verify native module compatibility with expo-doctor",
+            "Check React Native version bump (Expo SDK pins a specific RN version)",
+        ],
+        dependency_actions: [
+            "Run: npx expo install --check (list packages needing updates)",
+            "Update @react-navigation/* packages if using React Navigation directly",
+            "Update react-native-reanimated, react-native-gesture-handler to compatible versions",
+            "Check third-party native modules for SDK compatibility",
+            "Run: npm outdated (check for other stale dependencies)",
+        ],
+        rollback_strategy: [
+            "git stash or git checkout to restore pre-upgrade state",
+            "Restore package.json and package-lock.json from git",
+            "Run npm install to restore node_modules",
+            "Run npx expo prebuild --clean to regenerate native projects",
+            "If using EAS, the previous build is still available for download",
+        ],
+    };
+}
+function getFlutterUpgradeSteps(current, target) {
+    return {
+        framework: "flutter",
+        current_version: current,
+        target_version: target || "latest stable",
+        pre_upgrade_checklist: [
+            "Commit all current changes to git",
+            "Run flutter test and confirm tests pass",
+            "Run flutter analyze to check for existing issues",
+            "Review Flutter release notes at docs.flutter.dev/release/release-notes",
+            "Back up pubspec.yaml and pubspec.lock",
+        ],
+        upgrade_steps: [
+            `Run: flutter upgrade${target ? ` ${target}` : ""}`,
+            "Run: flutter pub upgrade --major-versions (update dependencies)",
+            "Run: flutter pub get",
+            "Run: flutter analyze (check for new lint warnings)",
+            "Run: dart fix --apply (auto-fix deprecations)",
+            "Run: flutter clean && flutter pub get",
+            "Test on both iOS and Android",
+        ],
+        breaking_changes: [
+            "Check for deprecated Widget APIs removed in the new version",
+            "Review Material 3 migration status if upgrading across major versions",
+            "Check Gradle and AGP version requirements for Android",
+            "Verify CocoaPods and Xcode version compatibility for iOS",
+            "Check for Dart language version changes affecting your code",
+        ],
+        dependency_actions: [
+            "Run: flutter pub outdated (list packages needing updates)",
+            "Update go_router, riverpod, bloc if using those packages",
+            "Check native plugin compatibility (firebase, maps, camera)",
+            "Update build.gradle minSdkVersion if required by new Flutter",
+            "Update Podfile deployment target if required",
+        ],
+        rollback_strategy: [
+            "git checkout to restore pre-upgrade state",
+            "Restore pubspec.yaml and pubspec.lock from git",
+            "Run flutter pub get to restore packages",
+            "Run flutter clean to clear build artifacts",
+            "Use flutter downgrade if needed (only works for latest->previous)",
+        ],
+    };
+}
+export function register(server) {
+    server.tool("mobile_upgradeSDK", "Detect current SDK version, compare to target, and generate a step-by-step upgrade plan with dependency fixes, breaking change warnings, and rollback strategy.", inputSchema, async (args) => {
+        try {
+            const root = args.project_path || process.cwd();
+            if (!existsSync(root)) {
+                return errorResponse(new Error(`Project path does not exist: ${root}`));
+            }
+            const isFlutter = args.framework === "flutter";
+            const currentVersion = isFlutter
+                ? detectFlutterVersion(root)
+                : detectExpoVersion(root);
+            const report = isFlutter
+                ? getFlutterUpgradeSteps(currentVersion, args.target_version ?? null)
+                : getExpoUpgradeSteps(currentVersion, args.target_version ?? null);
+            return textResponse(JSON.stringify(report, null, 2));
+        }
+        catch (err) {
+            return errorResponse(err);
+        }
+    });
+}
+//# sourceMappingURL=upgradeSDK.js.map

package/dist/tools/upgradeSDK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgradeSDK.js","sourceRoot":"","sources":["../../src/tools/upgradeSDK.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tmhs/mobile-mcp",
-  "version": "0.11.0",
-  "description": "MCP server for mobile app development - 33 tools for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, build health, push notifications, deep links, dev environment reset, store builds, metadata validation, App Store submission, Play Store submission, screenshot capture, bundle analysis, OTA update configuration, test execution, CI/CD setup, test file generation, i18n setup, map integration, form generation, real-time client setup, security auditing, performance profiling, offline readiness checks, APM monitoring setup, theming setup, accessibility auditing, and feature flag configuration.",
+  "version": "0.12.0",
+  "description": "MCP server for mobile app development - 36 tools for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, build health, push notifications, deep links, dev environment reset, store builds, metadata validation, App Store submission, Play Store submission, screenshot capture, bundle analysis, OTA update configuration, test execution, CI/CD setup, test file generation, i18n setup, map integration, form generation, real-time client setup, security auditing, performance profiling, offline readiness checks, APM monitoring setup, theming setup, accessibility auditing, feature flag configuration, native module scaffolding, SDK upgrade planning, and native compatibility auditing.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {