mcp-macos 2.1.5 → 4.0.0

package/README.md

@@ -2,9 +2,7 @@
 
 > Based on [FradSer/mcp-server-apple-events](https://github.com/FradSer/mcp-server-apple-events)
 
-MCP server for Reminders, Calendar, Notes, Mail, Messages, and Contacts on macOS. Works with Claude Desktop locally, or Claude iOS/web remotely via Cloudflare Tunnel.
-
-Requires a Mac. For always-on remote access, a Mac Mini or Mac Studio is recommended.
+MCP server for Reminders, Calendar, Notes, Mail, Messages, and Contacts on macOS. Local stdio transport for Claude Desktop, Claude Code, and Cursor.
 
 ## Quick Start
 
@@ -47,7 +45,7 @@ Checks macOS version, Node.js, EventKit binary, Full Disk Access, and JXA automa
 
 Both underscore (`reminders_tasks`) and dot (`reminders.tasks`) notation work.
 
-## Local Setup (stdio)
+## Setup
 
 ### Prerequisites
 
@@ -93,33 +91,6 @@ Messages and Mail read SQLite databases directly, so your terminal app (Terminal
 
 Run `macos-mcp --check` to verify. See [Troubleshooting](#troubleshooting) if anything fails.
 
-## Remote Setup (Claude iOS/web)
-
-Access your Mac's apps from Claude iOS or Claude web via Cloudflare Tunnel.
-
-```
-┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
-│   Claude iOS    │──────│  Cloudflare     │──────│   Your Mac      │
-│   or Web        │ HTTPS│  Edge + Access  │tunnel│   macos-mcp     │
-└─────────────────┘      └─────────────────┘      └─────────────────┘
-```
-
-### What you'll set up
-
-1. **Cloudflare Tunnel** — outbound connection from your Mac to Cloudflare's edge
-2. **Cloudflare Access** — email OTP authentication so only you can connect
-3. **LaunchAgents** — auto-start on boot for both the server and tunnel
-4. **Permissions** — Automation + Full Disk Access granted to the node binary
-
-### Prerequisites
-
-- Cloudflare account (free tier works)
-- Custom domain in Cloudflare (or `.cfargotunnel.com` subdomain)
-- Always-on Mac (Mac Mini/Studio recommended)
-- macos-mcp built and working locally (`pnpm build && macos-mcp --check`)
-
-Full setup guide: **[`docs/CLOUDFLARE_SETUP.md`](docs/CLOUDFLARE_SETUP.md)**
-
 ## Troubleshooting
 
 ### Quick-Fix Commands
@@ -134,13 +105,10 @@ open "x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles"
 
 ### Full Disk Access (Messages & Mail)
 
-Messages and Mail read SQLite databases (`~/Library/Messages/chat.db` and `~/Library/Mail/V10/MailData/Envelope Index`). These require Full Disk Access.
-
-- **stdio**: Grant FDA to your terminal app
-- **HTTP / LaunchAgent**: Grant FDA to the **actual node binary**, not a version manager shim
+Messages and Mail read SQLite databases (`~/Library/Messages/chat.db` and `~/Library/Mail/V10/MailData/Envelope Index`). These require Full Disk Access on your terminal app.
 
 ```bash
-# Find your real node binary
+# Find your real node binary (version managers use shims)
 node -e "console.log(process.execPath)"
 
 # Reveal it in Finder for drag-and-drop into FDA settings
@@ -164,8 +132,6 @@ System Settings may not show binaries in hidden directories — use `open -R` ab
 
 On first use, macOS prompts for Automation access. Grant via **System Settings > Privacy & Security > Automation**.
 
-> **Headless / LaunchAgent:** Automation dialogs can't appear through a LaunchAgent or SSH. Grant them once from a local Terminal session. Once granted, they persist across reboots. See [`docs/CLOUDFLARE_SETUP.md`](docs/CLOUDFLARE_SETUP.md) Step 10.
-
 Verify permissions:
 
 ```bash
@@ -182,23 +148,14 @@ Each command should return a value. A hang means the permission dialog is trying
 
 Gmail stores all messages in `[Gmail]/All Mail` and uses labels for folder membership. The server checks both the direct mailbox and labels join table. If Gmail inbox messages are missing, verify the Mail app has fully synced.
 
-### Server Restart (LaunchAgent)
-
-Restart **both** services — the server and the tunnel are separate:
-
-```bash
-launchctl kickstart -k gui/$(id -u)/com.macos-mcp.server
-launchctl kickstart -k gui/$(id -u)/com.cloudflare.macos-mcp-tunnel
-```
-
 ## Development
 
 ```bash
 pnpm install          # Install dependencies
 pnpm build            # Build TypeScript + Swift binary
-pnpm test             # Run full test suite (~900 tests)
+pnpm test             # Run full test suite
 pnpm lint             # Lint and format (Biome + TypeScript)
-pnpm dev              # Run from source via tsx (stdio only)
+pnpm dev              # Run from source via tsx
 ```
 
 Production entry point (`bin/run.cjs`) requires `pnpm build`. Use `pnpm dev` for local development.
@@ -211,19 +168,9 @@ Three bridges to Apple apps:
 - **JXA** — Notes, Mail writes, Contacts. Scripts run via `osascript -l JavaScript`.
 - **SQLite** — Messages reads (`~/Library/Messages/chat.db`), Mail reads (`~/Library/Mail/V10/MailData/Envelope Index`). JXA message reading is broken on Sonoma+; JXA mail reading is too slow for real inboxes.
 
-### HTTP Transport
-
-Set via environment variables or `macos-mcp.config.json`:
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `MCP_TRANSPORT` | `stdio` | `stdio`, `http`, or `both` |
-| `MCP_HTTP_ENABLED` | `false` | Enable HTTP transport |
-| `MCP_HTTP_PORT` | `3847` | HTTP server port |
-
 ### Dependencies
 
-**Runtime:** `@modelcontextprotocol/sdk`, `express`, `jose`, `zod`
+**Runtime:** `@modelcontextprotocol/sdk`, `zod`
 
 **Dev:** `typescript`, `tsx`, `jest`, `@biomejs/biome`
 

package/dist/config/index.d.ts

@@ -1,36 +1,9 @@
 /**
- * @fileoverview Configuration loading and management for macos-mcp server
+ * @fileoverview Configuration loader for macos-mcp server
  * @module config
- * @description Loads configuration from file and environment variables with auto-injection of package.json metadata
- */
-import { type CloudflareAccessConfig, type FullServerConfig, type HttpConfig } from './schema.js';
-/**
- * Loads server configuration from file and environment variables
- *
- * Configuration is loaded in the following priority (highest to lowest):
- * 1. Environment variables (MCP_TRANSPORT, MCP_HTTP_*, CF_ACCESS_*)
- * 2. Configuration file (macos-mcp.config.json in project root)
- * 3. Default values from schema
- *
- * Name and version are always auto-injected from package.json
- *
- * @returns Validated server configuration
- * @throws Error if configuration is invalid
- *
- * @example
- * // Basic usage
- * const config = loadConfig();
- * console.log(config.transport); // 'stdio' (default)
- *
- * @example
- * // With environment variables
- * // MCP_TRANSPORT=http
- * // MCP_HTTP_ENABLED=true
- * // MCP_HTTP_PORT=8080
- * const config = loadConfig();
- * console.log(config.transport); // 'http'
- * console.log(config.http?.port); // 8080
+ * @description Auto-injects name + version from package.json
  */
+import { type FullServerConfig } from './schema.js';
 export declare function loadConfig(): FullServerConfig;
-export type { CloudflareAccessConfig, FullServerConfig, HttpConfig };
-export { CloudflareAccessConfigSchema, HttpConfigSchema, ServerConfigSchema, } from './schema.js';
+export type { FullServerConfig };
+export { ServerConfigSchema } from './schema.js';

package/dist/config/index.js

@@ -1,127 +1,20 @@
 /**
- * @fileoverview Configuration loading and management for macos-mcp server
+ * @fileoverview Configuration loader for macos-mcp server
  * @module config
- * @description Loads configuration from file and environment variables with auto-injection of package.json metadata
+ * @description Auto-injects name + version from package.json
  */
-import { existsSync, readFileSync } from 'node:fs';
+import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { findProjectRoot } from '../utils/projectUtils.js';
-import { ServerConfigSchema, } from './schema.js';
-/** Configuration file name */
-const CONFIG_FILENAME = 'macos-mcp.config.json';
-/**
- * Loads server configuration from file and environment variables
- *
- * Configuration is loaded in the following priority (highest to lowest):
- * 1. Environment variables (MCP_TRANSPORT, MCP_HTTP_*, CF_ACCESS_*)
- * 2. Configuration file (macos-mcp.config.json in project root)
- * 3. Default values from schema
- *
- * Name and version are always auto-injected from package.json
- *
- * @returns Validated server configuration
- * @throws Error if configuration is invalid
- *
- * @example
- * // Basic usage
- * const config = loadConfig();
- * console.log(config.transport); // 'stdio' (default)
- *
- * @example
- * // With environment variables
- * // MCP_TRANSPORT=http
- * // MCP_HTTP_ENABLED=true
- * // MCP_HTTP_PORT=8080
- * const config = loadConfig();
- * console.log(config.transport); // 'http'
- * console.log(config.http?.port); // 8080
- */
+import { ServerConfigSchema } from './schema.js';
 export function loadConfig() {
     const projectRoot = findProjectRoot();
-    const configPath = join(projectRoot, CONFIG_FILENAME);
-    // Load file configuration if it exists
-    let fileConfig = {};
-    if (existsSync(configPath)) {
-        const fileContent = readFileSync(configPath, 'utf-8');
-        fileConfig = JSON.parse(fileContent);
-    }
-    // Build environment variable configuration
-    const envConfig = buildEnvConfig();
-    // Deep merge file config with env config (env takes precedence)
-    const merged = deepMerge(fileConfig, envConfig);
-    // Load package.json for name and version
     const packageJsonPath = join(projectRoot, 'package.json');
     const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-    // Parse and validate configuration
     return ServerConfigSchema.parse({
         name: packageJson.name,
         version: packageJson.version,
-        ...merged,
     });
 }
-/**
- * Builds configuration object from environment variables
- * @returns Partial configuration from environment variables
- */
-function buildEnvConfig() {
-    const config = {};
-    // Transport mode
-    if (process.env.MCP_TRANSPORT) {
-        config.transport = process.env.MCP_TRANSPORT;
-    }
-    // HTTP configuration (only if explicitly enabled)
-    if (process.env.MCP_HTTP_ENABLED === 'true') {
-        const httpConfig = {
-            enabled: true,
-        };
-        if (process.env.MCP_HTTP_HOST) {
-            httpConfig.host = process.env.MCP_HTTP_HOST;
-        }
-        if (process.env.MCP_HTTP_PORT) {
-            const port = Number.parseInt(process.env.MCP_HTTP_PORT, 10);
-            if (!Number.isNaN(port)) {
-                httpConfig.port = port;
-            }
-        }
-        // Cloudflare Access configuration
-        if (process.env.CF_ACCESS_TEAM_DOMAIN && process.env.CF_ACCESS_POLICY_AUD) {
-            const cfConfig = {
-                teamDomain: process.env.CF_ACCESS_TEAM_DOMAIN,
-                policyAUD: process.env.CF_ACCESS_POLICY_AUD,
-            };
-            if (process.env.CF_ACCESS_ALLOWED_EMAILS) {
-                cfConfig.allowedEmails = process.env.CF_ACCESS_ALLOWED_EMAILS.split(',').map((e) => e.trim());
-            }
-            httpConfig.cloudflareAccess = cfConfig;
-        }
-        config.http = httpConfig;
-    }
-    return config;
-}
-/**
- * Deep merges two objects, with source taking precedence
- * @param target - Base object
- * @param source - Object to merge in (takes precedence)
- * @returns Merged object
- */
-function deepMerge(target, source) {
-    const result = { ...target };
-    for (const key of Object.keys(source)) {
-        const sourceValue = source[key];
-        const targetValue = result[key];
-        if (sourceValue !== null &&
-            typeof sourceValue === 'object' &&
-            !Array.isArray(sourceValue) &&
-            targetValue !== null &&
-            typeof targetValue === 'object' &&
-            !Array.isArray(targetValue)) {
-            result[key] = deepMerge(targetValue, sourceValue);
-        }
-        else if (sourceValue !== undefined) {
-            result[key] = sourceValue;
-        }
-    }
-    return result;
-}
-export { CloudflareAccessConfigSchema, HttpConfigSchema, ServerConfigSchema, } from './schema.js';
+export { ServerConfigSchema } from './schema.js';
 //# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAyB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,UAAU,UAAU;IACxB,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IACtC,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAGpE,CAAC;IAEF,OAAO,kBAAkB,CAAC,KAAK,CAAC;QAC9B,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,OAAO,EAAE,WAAW,CAAC,OAAO;KAC7B,CAAC,CAAC;AACL,CAAC;AAGD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/config/schema.d.ts

@@ -1,161 +1,18 @@
 /**
- * @fileoverview Configuration schema definitions for macos-mcp server
+ * @fileoverview Configuration schema for macos-mcp server
  * @module config/schema
- * @description Zod schemas for transport mode, HTTP settings, and Cloudflare Access configuration
  */
 import { z } from 'zod/v3';
-/**
- * Cloudflare Access configuration schema for JWT verification
- * Required when using Cloudflare Tunnel for secure remote access
- */
-export declare const CloudflareAccessConfigSchema: z.ZodObject<{
-    /** Cloudflare Access team domain (e.g., "myteam.cloudflareaccess.com") */
-    teamDomain: z.ZodString;
-    /** Application Audience (AUD) tag from Cloudflare Access policy */
-    policyAUD: z.ZodString;
-    /** Optional list of allowed email addresses for additional verification */
-    allowedEmails: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    teamDomain: string;
-    policyAUD: string;
-    allowedEmails?: string[] | undefined;
-}, {
-    teamDomain: string;
-    policyAUD: string;
-    allowedEmails?: string[] | undefined;
-}>;
-/**
- * HTTP transport configuration schema
- */
-export declare const HttpConfigSchema: z.ZodObject<{
-    /** Whether HTTP transport is enabled */
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Host to bind the HTTP server to */
-    host: z.ZodDefault<z.ZodString>;
-    /** Port for the HTTP server (1-65535) */
-    port: z.ZodDefault<z.ZodNumber>;
-    /** Cloudflare Access configuration for JWT verification */
-    cloudflareAccess: z.ZodOptional<z.ZodObject<{
-        /** Cloudflare Access team domain (e.g., "myteam.cloudflareaccess.com") */
-        teamDomain: z.ZodString;
-        /** Application Audience (AUD) tag from Cloudflare Access policy */
-        policyAUD: z.ZodString;
-        /** Optional list of allowed email addresses for additional verification */
-        allowedEmails: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        teamDomain: string;
-        policyAUD: string;
-        allowedEmails?: string[] | undefined;
-    }, {
-        teamDomain: string;
-        policyAUD: string;
-        allowedEmails?: string[] | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    enabled: boolean;
-    host: string;
-    port: number;
-    cloudflareAccess?: {
-        teamDomain: string;
-        policyAUD: string;
-        allowedEmails?: string[] | undefined;
-    } | undefined;
-}, {
-    enabled?: boolean | undefined;
-    host?: string | undefined;
-    port?: number | undefined;
-    cloudflareAccess?: {
-        teamDomain: string;
-        policyAUD: string;
-        allowedEmails?: string[] | undefined;
-    } | undefined;
-}>;
-/**
- * Full server configuration schema
- */
 export declare const ServerConfigSchema: z.ZodObject<{
     /** Server name (auto-populated from package.json) */
     name: z.ZodString;
     /** Server version (auto-populated from package.json) */
     version: z.ZodString;
-    /** Transport mode: stdio (default), http, or both */
-    transport: z.ZodDefault<z.ZodEnum<["stdio", "http", "both"]>>;
-    /** HTTP transport configuration (required when transport includes http) */
-    http: z.ZodOptional<z.ZodObject<{
-        /** Whether HTTP transport is enabled */
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Host to bind the HTTP server to */
-        host: z.ZodDefault<z.ZodString>;
-        /** Port for the HTTP server (1-65535) */
-        port: z.ZodDefault<z.ZodNumber>;
-        /** Cloudflare Access configuration for JWT verification */
-        cloudflareAccess: z.ZodOptional<z.ZodObject<{
-            /** Cloudflare Access team domain (e.g., "myteam.cloudflareaccess.com") */
-            teamDomain: z.ZodString;
-            /** Application Audience (AUD) tag from Cloudflare Access policy */
-            policyAUD: z.ZodString;
-            /** Optional list of allowed email addresses for additional verification */
-            allowedEmails: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            teamDomain: string;
-            policyAUD: string;
-            allowedEmails?: string[] | undefined;
-        }, {
-            teamDomain: string;
-            policyAUD: string;
-            allowedEmails?: string[] | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        enabled: boolean;
-        host: string;
-        port: number;
-        cloudflareAccess?: {
-            teamDomain: string;
-            policyAUD: string;
-            allowedEmails?: string[] | undefined;
-        } | undefined;
-    }, {
-        enabled?: boolean | undefined;
-        host?: string | undefined;
-        port?: number | undefined;
-        cloudflareAccess?: {
-            teamDomain: string;
-            policyAUD: string;
-            allowedEmails?: string[] | undefined;
-        } | undefined;
-    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     version: string;
-    transport: "stdio" | "http" | "both";
-    http?: {
-        enabled: boolean;
-        host: string;
-        port: number;
-        cloudflareAccess?: {
-            teamDomain: string;
-            policyAUD: string;
-            allowedEmails?: string[] | undefined;
-        } | undefined;
-    } | undefined;
 }, {
     name: string;
     version: string;
-    http?: {
-        enabled?: boolean | undefined;
-        host?: string | undefined;
-        port?: number | undefined;
-        cloudflareAccess?: {
-            teamDomain: string;
-            policyAUD: string;
-            allowedEmails?: string[] | undefined;
-        } | undefined;
-    } | undefined;
-    transport?: "stdio" | "http" | "both" | undefined;
 }>;
-/** Cloudflare Access configuration type */
-export type CloudflareAccessConfig = z.infer<typeof CloudflareAccessConfigSchema>;
-/** HTTP transport configuration type */
-export type HttpConfig = z.infer<typeof HttpConfigSchema>;
-/** Full server configuration type */
 export type FullServerConfig = z.infer<typeof ServerConfigSchema>;

package/dist/config/schema.js

@@ -1,45 +1,12 @@
 /**
- * @fileoverview Configuration schema definitions for macos-mcp server
+ * @fileoverview Configuration schema for macos-mcp server
  * @module config/schema
- * @description Zod schemas for transport mode, HTTP settings, and Cloudflare Access configuration
  */
 import { z } from 'zod/v3';
-/**
- * Cloudflare Access configuration schema for JWT verification
- * Required when using Cloudflare Tunnel for secure remote access
- */
-export const CloudflareAccessConfigSchema = z.object({
-    /** Cloudflare Access team domain (e.g., "myteam.cloudflareaccess.com") */
-    teamDomain: z.string().min(1, 'Team domain is required'),
-    /** Application Audience (AUD) tag from Cloudflare Access policy */
-    policyAUD: z.string().min(1, 'Policy AUD is required'),
-    /** Optional list of allowed email addresses for additional verification */
-    allowedEmails: z.array(z.string().email('Invalid email format')).optional(),
-});
-/**
- * HTTP transport configuration schema
- */
-export const HttpConfigSchema = z.object({
-    /** Whether HTTP transport is enabled */
-    enabled: z.boolean().default(false),
-    /** Host to bind the HTTP server to */
-    host: z.string().default('127.0.0.1'),
-    /** Port for the HTTP server (1-65535) */
-    port: z.number().int().min(1).max(65535).default(3847),
-    /** Cloudflare Access configuration for JWT verification */
-    cloudflareAccess: CloudflareAccessConfigSchema.optional(),
-});
-/**
- * Full server configuration schema
- */
 export const ServerConfigSchema = z.object({
     /** Server name (auto-populated from package.json) */
     name: z.string(),
     /** Server version (auto-populated from package.json) */
     version: z.string(),
-    /** Transport mode: stdio (default), http, or both */
-    transport: z.enum(['stdio', 'http', 'both']).default('stdio'),
-    /** HTTP transport configuration (required when transport includes http) */
-    http: HttpConfigSchema.optional(),
 });
 //# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,0EAA0E;IAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACxD,mEAAmE;IACnE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACtD,2EAA2E;IAC3E,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5E,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,wCAAwC;IACxC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,sCAAsC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IACrC,yCAAyC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACtD,2DAA2D;IAC3D,gBAAgB,EAAE,4BAA4B,CAAC,QAAQ,EAAE;CAC1D,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,qDAAqD;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,wDAAwD;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,qDAAqD;IACrD,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7D,2EAA2E;IAC3E,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,qDAAqD;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,wDAAwD;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,11 +1,6 @@
 #!/usr/bin/env node
 /**
  * index.ts
- * Entry point for the macOS MCP server
- *
- * Supports multiple transport modes:
- * - stdio: Standard input/output (default, for Claude Desktop)
- * - http: HTTP/SSE transport (for remote access via Cloudflare Tunnel)
- * - both: Run both transports simultaneously
+ * Entry point for the macOS MCP server (stdio transport)
  */
 export {};

package/dist/index.js

@@ -1,61 +1,21 @@
 #!/usr/bin/env node
 /**
  * index.ts
- * Entry point for the macOS MCP server
- *
- * Supports multiple transport modes:
- * - stdio: Standard input/output (default, for Claude Desktop)
- * - http: HTTP/SSE transport (for remote access via Cloudflare Tunnel)
- * - both: Run both transports simultaneously
+ * Entry point for the macOS MCP server (stdio transport)
  */
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { loadConfig } from './config/index.js';
 import { createServer } from './server/server.js';
 import { contactResolver } from './utils/contactResolver.js';
-/** Active HTTP transport instance for cleanup */
-let httpTransport = null;
-/**
- * Graceful shutdown handler
- * Stops HTTP server if running and exits cleanly
- */
-async function shutdown() {
-    process.stderr.write(`${JSON.stringify({ timestamp: new Date().toISOString(), event: 'shutdown_initiated' })}\n`);
-    if (httpTransport) {
-        await httpTransport.stop();
-    }
-    process.exit(0);
-}
-/**
- * Main entry point
- * Loads configuration and starts appropriate transport(s)
- */
 async function main() {
     const config = loadConfig();
     const server = createServer(config);
-    // Warm contact cache before connecting transports.
-    // Fire-and-forget: cache builds concurrently, giving maximum head start
-    // before the first enrichment request arrives.
+    // Warm contact cache before connecting transport.
+    // Fire-and-forget: cache builds concurrently with stdio handshake.
     void contactResolver.warmCache();
-    // Register graceful shutdown handlers
-    process.on('SIGINT', () => void shutdown());
-    process.on('SIGTERM', () => void shutdown());
-    // Start stdio transport if configured
-    if (config.transport === 'stdio' || config.transport === 'both') {
-        const stdioTransport = new StdioServerTransport();
-        await server.connect(stdioTransport);
-    }
-    // Start HTTP transport if configured
-    if (config.transport === 'http' || config.transport === 'both') {
-        if (!config.http?.enabled) {
-            throw new Error('HTTP transport requested but http.enabled is false');
-        }
-        // Dynamic import to avoid loading express when not needed
-        const { createHttpTransport } = await import('./server/transports/http/index.js');
-        httpTransport = createHttpTransport(server, config, config.http);
-        await httpTransport.start();
-    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
 }
-// Handle --check flag for preflight validation
 if (process.argv.includes('--check')) {
     import('./utils/preflight.js').then(async ({ runPreflight, formatResults }) => {
         const results = await runPreflight();
@@ -65,7 +25,6 @@ if (process.argv.includes('--check')) {
     });
 }
 else {
-    // Start the application
     main().catch((error) => {
         const errorMessage = error instanceof Error ? error.message : String(error);
         process.stderr.write(`${JSON.stringify({ timestamp: new Date().toISOString(), error: 'fatal', message: errorMessage })}\n`);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAyB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAqB,UAAU,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEpC,kDAAkD;IAClD,mEAAmE;IACnE,KAAK,eAAe,CAAC,SAAS,EAAE,CAAC;IAEjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;IACrC,MAAM,CAAC,sBAAsB,CAAC,CAAC,IAAI,CACjC,KAAK,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE,EAAE;QACxC,MAAM,OAAO,GAAG,MAAM,YAAY,EAAE,CAAC;QACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC,CACF,CAAC;AACJ,CAAC;KAAM,CAAC;IACN,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC9B,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,IAAI,CACtG,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server/handlers.js

@@ -2,15 +2,13 @@
  * server/handlers.ts
  * Request handlers for the MCP server
  */
-import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { handleToolCall, TOOLS } from '../tools/index.js';
-import { buildPromptResponse, getPromptDefinition, PROMPT_LIST, } from './prompts.js';
 /**
  * Registers all request handlers for the MCP server
  * @param server - The MCP server instance
  */
 export function registerHandlers(server) {
-    // Handler for listing available tools
     server.setRequestHandler(ListToolsRequestSchema, async () => {
         process.stderr.write(`${JSON.stringify({
             timestamp: new Date().toISOString(),
@@ -21,23 +19,6 @@ export function registerHandlers(server) {
         })}\n`);
         return { tools: TOOLS };
     });
-    // Handler for calling a tool
     server.setRequestHandler(CallToolRequestSchema, async (request) => handleToolCall(request.params.name, request.params.arguments ?? {}));
-    // Handler for listing available prompts
-    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
-        prompts: PROMPT_LIST,
-    }));
-    // Handler for getting a specific prompt
-    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
-        const { name, arguments: args } = request.params;
-        if (typeof name !== 'string') {
-            throw new Error('Prompt name must be a string.');
-        }
-        const promptDefinition = getPromptDefinition(name);
-        if (!promptDefinition) {
-            throw new Error(`Unknown prompt: ${name}`);
-        }
-        return buildPromptResponse(promptDefinition, args);
-    });
 }
 //# sourceMappingURL=handlers.js.map