@tmhs/mobile-mcp 0.11.0 → 1.0.0

package/LICENSE

@@ -0,0 +1,43 @@
+Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International
+
+Copyright (c) 2026 TM Hospitality Strategies
+
+This work is licensed under the Creative Commons
+Attribution-NonCommercial-NoDerivatives 4.0 International License.
+
+You are free to:
+
+  Share - copy and redistribute the material in any medium or format.
+
+  The licensor cannot revoke these freedoms as long as you follow the
+  license terms.
+
+Under the following terms:
+
+  Attribution - You must give appropriate credit, provide a link to the
+  license, and indicate if changes were made. You may do so in any
+  reasonable manner, but not in any way that suggests the licensor endorses
+  you or your use.
+
+  NonCommercial - You may not use the material for commercial purposes.
+
+  NoDerivatives - If you remix, transform, or build upon the material, you
+  may not distribute the modified material.
+
+  No additional restrictions - You may not apply legal terms or
+  technological measures that legally restrict others from doing anything
+  the license permits.
+
+Notices:
+
+  You do not have to comply with the license for elements of the material
+  in the public domain or where your use is permitted by an applicable
+  exception or limitation.
+
+  No warranties are given. The license may not give you all of the
+  permissions necessary for your intended use. For example, other rights
+  such as publicity, privacy, or moral rights may limit how you use the
+  material.
+
+For the full license text, see:
+https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode

package/README.md

@@ -0,0 +1,92 @@
+# @tmhs/mobile-mcp
+
+MCP server for mobile app development. **36 tools** that let AI agents scaffold, build, test, and ship React Native/Expo and Flutter apps.
+
+Part of [Mobile App Developer Tools](https://github.com/TMHSDigital/Mobile-App-Developer-Tools), a Cursor plugin with 43 skills, 12 rules, and this companion MCP server.
+
+## Install
+
+```bash
+npm install -g @tmhs/mobile-mcp
+```
+
+Requires **Node 20+**.
+
+## Quick start
+
+Add to your MCP client config (e.g. Cursor, Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "mobile-mcp": {
+      "command": "npx",
+      "args": ["-y", "@tmhs/mobile-mcp"]
+    }
+  }
+}
+```
+
+Or run directly:
+
+```bash
+npx @tmhs/mobile-mcp
+```
+
+The server communicates over **stdio** using the [Model Context Protocol](https://modelcontextprotocol.io/).
+
+## Tools (36)
+
+All tools use the `mobile_` prefix.
+
+| Tool | Description |
+| --- | --- |
+| `mobile_checkDevEnvironment` | Detect installed tools and SDKs (Node, Expo CLI, Watchman, Xcode, Android Studio, JDK) |
+| `mobile_scaffoldProject` | Generate a new Expo project from a template with chosen options |
+| `mobile_runOnDevice` | Start dev server and provide instructions for connecting a physical device |
+| `mobile_generateScreen` | Create a new Expo Router screen file with navigation wiring |
+| `mobile_generateComponent` | Create a React Native component with typed props, StyleSheet, and optional tests |
+| `mobile_installDependency` | Install a package via `npx expo install` with native module detection |
+| `mobile_addPermission` | Add platform permission with iOS rationale string to app.json |
+| `mobile_integrateAI` | Scaffold AI API client with provider config, error handling, and TypeScript types |
+| `mobile_checkBuildHealth` | Validate app.json, check dependencies, verify TypeScript, detect native module issues |
+| `mobile_addPushNotifications` | Add expo-notifications plugin, create notification handler, configure Android channel |
+| `mobile_configureDeepLinks` | Set scheme, add intent filters, iOS associated domains, generate AASA template |
+| `mobile_resetDevEnvironment` | Clear Metro cache, .expo dir, node_modules cache, optionally Pods and Gradle |
+| `mobile_buildForStore` | Create a production build for app store submission via EAS Build |
+| `mobile_validateStoreMetadata` | Check app.json for required store listing fields |
+| `mobile_submitToAppStore` | Submit latest iOS build to App Store Connect via EAS Submit |
+| `mobile_submitToPlayStore` | Submit latest Android build to Google Play Console via EAS Submit |
+| `mobile_generateScreenshots` | Generate screenshot capture script and list required store dimensions |
+| `mobile_analyzeBundle` | Analyze bundle for large dependencies, heavy assets, and optimization opportunities |
+| `mobile_configureOTA` | Configure EAS Update for over-the-air JavaScript updates |
+| `mobile_runTests` | Execute test suite (Jest or flutter test) and return structured results |
+| `mobile_setupCI` | Generate GitHub Actions CI workflow for build, test, and EAS Build |
+| `mobile_generateTestFile` | Scaffold a test file for an existing component or module |
+| `mobile_setupI18n` | Initialize i18n config with locale files and translation structure |
+| `mobile_addMap` | Add map view with provider config, permissions, and marker support |
+| `mobile_generateForm` | Scaffold a validated form with typed fields and error handling |
+| `mobile_setupRealtime` | Add real-time client with connection management and typed events |
+| `mobile_securityAudit` | Scan project for common mobile security anti-patterns |
+| `mobile_profilePerformance` | Analyze project for performance anti-patterns and flag jank/memory issues |
+| `mobile_checkOfflineReady` | Validate offline-first setup: local DB, network listener, query cache |
+| `mobile_setupMonitoring` | Configure APM with Sentry Performance or Datadog RUM |
+| `mobile_setupTheming` | Initialize design token system with light/dark themes and semantic colors |
+| `mobile_auditAccessibility` | Scan project for a11y violations: labels, touch targets, alt text |
+| `mobile_setupFeatureFlags` | Add typed feature flag provider with default values and remote sync |
+| `mobile_createNativeModule` | Scaffold an Expo Module or Flutter plugin with Swift/Kotlin stubs |
+| `mobile_upgradeSDK` | Generate SDK upgrade plan with dependency fixes and breaking changes |
+| `mobile_checkNativeCompat` | Audit packages for New Architecture support and deprecated dependencies |
+
+## Development
+
+```bash
+git clone https://github.com/TMHSDigital/Mobile-App-Developer-Tools.git
+cd Mobile-App-Developer-Tools/mcp-server
+npm install
+npm run build
+```
+
+## License
+
+[CC-BY-NC-ND-4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/) - Copyright 2026 TM Hospitality Strategies.

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: "1.0.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": "1.0.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": {
@@ -43,5 +43,15 @@
   "bugs": {
     "url": "https://github.com/TMHSDigital/Mobile-App-Developer-Tools/issues"
   },
-  "author": "TMHSDigital"
+  "author": "TMHSDigital",
+  "keywords": [
+    "mcp",
+    "mobile",
+    "react-native",
+    "expo",
+    "flutter",
+    "model-context-protocol",
+    "developer-tools",
+    "mobile-dev"
+  ]
 }