ios-agent-mcp 2.0.0

package/dist/scan.js

@@ -0,0 +1,153 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join, relative, resolve, sep } from "node:path";
+const SKIP_DIRS = new Set([
+    ".git", ".build", "DerivedData", "Pods", "Carthage",
+    "node_modules", ".swiftpm", "build", "vendor", "Vendor",
+]);
+const MAX_FILES = 2000;
+const MAX_FILE_BYTES = 512 * 1024;
+/** Walk a directory collecting paths that match `accept`. */
+async function walk(root, accept, limit) {
+    const found = [];
+    async function visit(dir) {
+        if (found.length >= limit)
+            return;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return; // unreadable directory — skip rather than fail the whole scan
+        }
+        for (const entry of entries) {
+            if (found.length >= limit)
+                return;
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (SKIP_DIRS.has(entry.name) || entry.name.endsWith(".xcodeproj"))
+                    continue;
+                await visit(full);
+            }
+            else if (accept(full)) {
+                found.push(full);
+            }
+        }
+    }
+    await visit(root);
+    return found;
+}
+/**
+ * Resolve and validate a project root.
+ *
+ * Rejects paths that do not exist or are not directories, so a typo produces a
+ * clear error rather than an empty, falsely-clean report.
+ */
+export async function resolveProjectRoot(path) {
+    const root = resolve(path);
+    let info;
+    try {
+        info = await stat(root);
+    }
+    catch {
+        throw new Error(`Path does not exist: ${root}`);
+    }
+    if (!info.isDirectory()) {
+        throw new Error(`Not a directory: ${root}`);
+    }
+    return root;
+}
+/**
+ * Is this a package manifest rather than application source?
+ *
+ * `Package.swift` and its versioned variants are build configuration. Analyzing
+ * them inflates file counts and produces findings against code that is not part
+ * of the app.
+ */
+function isManifest(path) {
+    return /(^|\/)Package(@swift-[\d.]+)?\.swift$/.test(path.split(sep).join("/"));
+}
+/** Read every Swift source file under `root`, capped for safety. */
+export async function readSwiftFiles(root) {
+    const paths = await walk(root, (p) => p.endsWith(".swift") && !isManifest(p), MAX_FILES);
+    const files = [];
+    for (const path of paths) {
+        try {
+            const info = await stat(path);
+            if (info.size > MAX_FILE_BYTES)
+                continue;
+            const content = await readFile(path, "utf8");
+            files.push({ path: relative(root, path).split(sep).join("/"), content });
+        }
+        catch {
+            // Unreadable file — skip it rather than aborting the scan.
+        }
+    }
+    return files;
+}
+/** Gather the project-level context the App Store checks need. */
+export async function readProjectContext(root) {
+    const plists = await walk(root, (p) => p.endsWith("Info.plist"), 20);
+    const manifests = await walk(root, (p) => p.endsWith("PrivacyInfo.xcprivacy"), 5);
+    let infoPlist = "";
+    for (const path of plists) {
+        try {
+            infoPlist += await readFile(path, "utf8");
+        }
+        catch {
+            // ignore
+        }
+    }
+    // An Info.plist or an Xcode project means this is an app target, not a
+    // library. App Store rules only apply to the former.
+    const xcodeprojs = await walk(root, (p) => p.endsWith(".pbxproj"), 3);
+    const isApp = plists.length > 0 || xcodeprojs.length > 0;
+    return { infoPlist, hasPrivacyManifest: manifests.length > 0, isApp };
+}
+/** A structural overview of the project, independent of rule violations. */
+export async function summarizeProject(root, files) {
+    const frameworks = new Set();
+    let lineCount = 0;
+    for (const file of files) {
+        lineCount += file.content.split("\n").length;
+        for (const match of file.content.matchAll(/^\s*import\s+(\w+)/gm)) {
+            frameworks.add(match[1]);
+        }
+    }
+    let deploymentTarget = null;
+    let swiftToolsVersion = null;
+    const packages = await walk(root, (p) => p.endsWith("Package.swift"), 5);
+    if (packages.length > 0) {
+        try {
+            const content = await readFile(packages[0], "utf8");
+            swiftToolsVersion = /swift-tools-version:\s*([\d.]+)/.exec(content)?.[1] ?? null;
+            deploymentTarget = /\.iOS\(\.v(\d+)\)/.exec(content)?.[1] ?? null;
+        }
+        catch {
+            // ignore
+        }
+    }
+    if (!deploymentTarget) {
+        const pbxproj = await walk(root, (p) => p.endsWith("project.pbxproj"), 3);
+        if (pbxproj.length > 0) {
+            try {
+                const content = await readFile(pbxproj[0], "utf8");
+                deploymentTarget = /IPHONEOS_DEPLOYMENT_TARGET = ([\d.]+)/.exec(content)?.[1] ?? null;
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    const xcodeprojs = await walk(root, (p) => p.endsWith(".pbxproj"), 3);
+    return {
+        swiftFileCount: files.length,
+        lineCount,
+        deploymentTarget,
+        swiftToolsVersion,
+        frameworks: [...frameworks].sort(),
+        hasTests: files.some((f) => /Tests?\.swift$/.test(f.path)),
+        hasPackageSwift: packages.length > 0,
+        hasXcodeProject: xcodeprojs.length > 0,
+    };
+}
+//# sourceMappingURL=scan.js.map

package/dist/scan.js.map

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

package/mcp.json

@@ -0,0 +1,35 @@
+{
+  "name": "ios-agent-mcp",
+  "displayName": "iOS Agent",
+  "version": "1.0.0",
+  "description": "Static analysis for modern iOS/Swift projects — Swift 6 actor isolation, architecture boundaries, SwiftUI, availability guards, and App Store readiness.",
+  "author": "Nagarjuna Reddy",
+  "license": "MIT",
+  "homepage": "https://github.com/Nagarjuna2997/ios-agent-skill",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Nagarjuna2997/ios-agent-skill.git",
+    "directory": "mcp-server"
+  },
+  "keywords": ["ios", "swift", "swiftui", "xcode", "apple", "static-analysis", "code-review"],
+  "runtime": {
+    "type": "node",
+    "minimumVersion": "18",
+    "transport": "stdio",
+    "command": "npx",
+    "args": ["-y", "ios-agent-mcp"]
+  },
+  "permissions": {
+    "filesystem": "read",
+    "network": "none",
+    "notes": "Reads .swift, Info.plist, Package.swift, and project.pbxproj files under the path you pass to a tool. Makes no network requests and writes nothing."
+  },
+  "tools": [
+    { "name": "analyze_swift_project", "summary": "Project overview plus a finding count for every rule category." },
+    { "name": "review_swift_concurrency", "summary": "Swift 6 actor isolation and concurrency defects." },
+    { "name": "review_swift_architecture", "summary": "Architecture boundaries, dependency injection, testability." },
+    { "name": "review_swiftui", "summary": "SwiftUI view and state defects, Dynamic Type, design tokens." },
+    { "name": "check_availability_guards", "summary": "Missing and over-restrictive @available guards." },
+    { "name": "audit_app_store_readiness", "summary": "Purpose strings, privacy manifest, accessibility, localization." }
+  ]
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "ios-agent-mcp",
+  "version": "2.0.0",
+  "description": "MCP server for modern iOS/Swift development — concurrency isolation, architecture boundaries, SwiftUI, and App Store readiness analysis",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "ios-agent-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "mcp.json",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test test/*.test.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ios",
+    "swift",
+    "swiftui",
+    "claude",
+    "cursor"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nagarjuna2997/ios-agent-skill.git",
+    "directory": "mcp-server"
+  },
+  "homepage": "https://github.com/Nagarjuna2997/ios-agent-skill/tree/main/mcp-server",
+  "bugs": {
+    "url": "https://github.com/Nagarjuna2997/ios-agent-skill/issues"
+  }
+}