@heznpc/imcp 0.9.0 → 1.1.0

package/dist/shortcuts/prompts.js

@@ -0,0 +1,148 @@
+import { z } from "zod";
+import { userPrompt } from "../shared/prompt.js";
+export function registerShortcutPrompts(server) {
+    server.prompt("shortcut-automation", {
+        goal: z.string().describe("The automation goal or workflow you want to achieve"),
+        input: z.string().optional().describe("Optional initial input data for the workflow"),
+    }, ({ goal, input }) => {
+        const inputCtx = input ? `\nInitial input data: "${input}"` : "";
+        return userPrompt("Guide for creating complex automation workflows by chaining multiple shortcuts.", `Build an automation workflow to achieve: "${goal}"${inputCtx}
+
+Execute the following steps using iMcp tools:
+
+1. **Discover available shortcuts**:
+   - list_shortcuts to get all available Siri Shortcuts on this Mac
+   - search_shortcuts with keywords related to "${goal}" to find relevant shortcuts
+   - For each promising match, use get_shortcut_detail to understand what it does and what actions it contains
+
+2. **Analyze and plan the workflow**:
+   - Identify which shortcuts can be chained together to accomplish the goal
+   - Determine the execution order based on input/output dependencies
+   - Note which shortcuts accept text input and which produce output
+   - Identify any gaps where no existing shortcut covers a needed step
+   - Present the proposed workflow plan to me for confirmation
+
+3. **Execute the workflow**:
+   - Run each shortcut in sequence using run_shortcut with the appropriate name and input
+   - Pass the output of one shortcut as the input to the next when chaining
+   - If a shortcut fails, report the error and suggest alternatives
+   - Track the output at each step for the final summary
+
+4. **Report results**:
+   - Show the output from each step in the chain
+   - Highlight any steps that produced unexpected results
+   - Suggest improvements or additional shortcuts that could enhance the workflow
+   - If a step failed, explain what went wrong and possible fixes
+
+Important:
+- Always use exact shortcut names from list_shortcuts or search_shortcuts — names must match exactly
+- Some shortcuts may trigger UI prompts or require user interaction — warn me before running those
+- Never assume a shortcut exists; always verify with search_shortcuts first
+- Ask for confirmation before running shortcuts that perform destructive or irreversible actions`);
+    });
+    server.prompt("shortcut-discovery", {
+        category: z.string().optional().describe("Optional category or keyword to focus the discovery (e.g. 'productivity', 'media', 'text')"),
+    }, ({ category }) => {
+        const filterCtx = category
+            ? `Focus on shortcuts related to "${category}".`
+            : "Cover all available shortcuts.";
+        return userPrompt("Help users find, understand, and explore their available Siri Shortcuts.", `Help me discover and understand my available Siri Shortcuts. ${filterCtx}
+
+Execute the following steps using iMcp tools:
+
+1. **List all shortcuts**:
+   - list_shortcuts to get the complete list of Siri Shortcuts on this Mac
+   - Report the total count${category ? `\n   - search_shortcuts(query: "${category}") to filter for the relevant category` : ""}
+
+2. **Categorize shortcuts**:
+   - Group shortcuts by inferred purpose based on their names:
+     * Productivity (text processing, file operations, data conversion)
+     * Communication (messaging, email, sharing)
+     * Media (photos, music, video)
+     * System (settings, device control, automation)
+     * Developer (build, deploy, git, code)
+     * Custom/Other
+   - Present the categorized list clearly
+
+3. **Deep-dive into interesting shortcuts**:
+   - For shortcuts with unclear names, use get_shortcut_detail to inspect their actions
+   - Identify which shortcuts accept input and what type
+   - Identify which shortcuts produce output
+   - Flag shortcuts that might interact with external services or perform system changes
+
+4. **Provide recommendations**:
+   - Suggest useful shortcuts the user might not know they have
+   - Identify shortcuts that could be combined for powerful workflows
+   - Point out shortcuts that overlap in functionality
+   - Suggest common tasks that could be automated with the existing shortcuts
+
+5. **Summary report**:
+   - Total shortcuts available
+   - Breakdown by category
+   - Top recommendations for daily use
+   - Potential workflow combinations
+
+Important:
+- Use get_shortcut_detail on shortcuts with ambiguous names to provide accurate descriptions
+- Do not run any shortcuts during discovery — this is a read-only exploration
+- If the list is very large, focus on the most useful categories first`);
+    });
+    server.prompt("shortcut-troubleshooting", {
+        shortcutName: z.string().describe("Name of the shortcut that is having issues"),
+        errorDescription: z.string().optional().describe("Description of the error or unexpected behavior"),
+    }, ({ shortcutName, errorDescription }) => {
+        const errorCtx = errorDescription
+            ? `\nReported issue: "${errorDescription}"`
+            : "";
+        return userPrompt("Diagnose and fix shortcut execution issues.", `Troubleshoot the Siri Shortcut "${shortcutName}".${errorCtx}
+
+Execute the following steps using iMcp tools:
+
+1. **Verify the shortcut exists**:
+   - search_shortcuts(query: "${shortcutName}") to find the shortcut
+   - If not found, list_shortcuts to show all available shortcuts and suggest the closest match
+   - Confirm the exact name (names are case-sensitive and must match exactly)
+
+2. **Inspect the shortcut**:
+   - get_shortcut_detail(name: "${shortcutName}") to examine its actions and structure
+   - Identify what the shortcut is designed to do
+   - Check what input it expects (if any)
+   - Identify actions that depend on external services, apps, or permissions
+
+3. **Test execution**:
+   - run_shortcut(name: "${shortcutName}") with no input to test basic execution
+   - If the shortcut expects input, run_shortcut with a simple test input
+   - Capture and analyze any error messages from the output
+
+4. **Diagnose the issue**:
+   Based on the inspection and test results, check for these common problems:
+   - **Name mismatch**: The name used doesn't exactly match the shortcut name
+   - **Missing input**: The shortcut requires input but none was provided
+   - **Wrong input type**: The shortcut expects a specific input format
+   - **Permission issues**: The shortcut needs permissions that haven't been granted
+   - **App dependency**: The shortcut relies on an app that isn't installed or available
+   - **Network dependency**: The shortcut needs internet access for an API or web request
+   - **UI interaction required**: The shortcut triggers a dialog that blocks automation
+   - **Timeout**: The shortcut takes too long to complete via CLI
+
+5. **Provide solutions**:
+   - Explain the diagnosed root cause clearly
+   - Suggest specific fixes:
+     * Correct name to use with run_shortcut
+     * Required input format and example
+     * Permission steps to resolve access issues
+     * Alternative shortcuts that accomplish the same goal
+   - If the shortcut cannot be fixed via MCP, explain what manual steps are needed in the Shortcuts app
+
+6. **Verification**:
+   - After applying fixes, re-run the shortcut to confirm it works
+   - Show the successful output
+
+Important:
+- Some shortcuts will trigger UI prompts — warn me before running them
+- If a shortcut consistently fails, it may need to be edited in the Shortcuts app directly
+- Report the exact error output for accurate diagnosis
+- Do not modify or delete any shortcuts — only inspect and run them`);
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/shortcuts/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/shortcuts/prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,MAAM,CACX,qBAAqB,EACrB;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;QAChF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;KACtF,EACD,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,0BAA0B,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,OAAO,UAAU,CACf,iFAAiF,EACjF,6CAA6C,IAAI,IAAI,QAAQ;;;;;;kDAMnB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;iGA0B2C,CAC1F,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,oBAAoB,EACpB;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4FAA4F,CAAC;KACvI,EACD,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;QACf,MAAM,SAAS,GAAG,QAAQ;YACxB,CAAC,CAAC,kCAAkC,QAAQ,IAAI;YAChD,CAAC,CAAC,gCAAgC,CAAC;QACrC,OAAO,UAAU,CACf,0EAA0E,EAC1E,gEAAgE,SAAS;;;;;;6BAMpD,QAAQ,CAAC,CAAC,CAAC,mCAAmC,QAAQ,wCAAwC,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEAiCzD,CAChE,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,0BAA0B,EAC1B;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QAC/E,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;KACpG,EACD,CAAC,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAAE,EAAE;QACrC,MAAM,QAAQ,GAAG,gBAAgB;YAC/B,CAAC,CAAC,sBAAsB,gBAAgB,GAAG;YAC3C,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,UAAU,CACf,6CAA6C,EAC7C,mCAAmC,YAAY,KAAK,QAAQ;;;;;gCAKpC,YAAY;;;;;kCAKV,YAAY;;;;;;2BAMnB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAgC6B,CAC7D,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/system/scripts.js

@@ -4,8 +4,10 @@ export function getClipboardScript() {
     return `
     const app = Application.currentApplication();
     app.includeStandardAdditions = true;
-    const text = app.theClipboard();
-    JSON.stringify({content: String(text)});
+    let text;
+    try { text = app.theClipboard(); } catch(e) { text = ''; }
+    const content = (typeof text === 'object') ? JSON.stringify(text) : String(text);
+    JSON.stringify({content: content});
   `;
 }
 export function setClipboardScript(text) {

package/dist/system/scripts.js.map

@@ -1 +1 @@
-{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../../src/system/scripts.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;GAKN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO;;;oBAGW,GAAG,CAAC,IAAI,CAAC;;;GAG1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;;;;;;GASN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAe,EAAE,KAAe;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxG,IAAI,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,EAAE,CAAC,CAAC;IAC7D,OAAO;;;2BAGkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;GAMxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO;;;;;GAKN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;GAUN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;GAeN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;GAkBN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,MAAe;IACnE,MAAM,UAAU,GAAG,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACrF,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO;;;yCAGgC,UAAU,KAAK,QAAQ;oDACZ,QAAQ;6CACf,GAAG,CAAC,IAAI,CAAC;GACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,KAAc,EAAE,QAAiB,EAAE,KAAc;IACvG,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,OAAO;;;+BAGsB,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;4CACrB,GAAG,CAAC,OAAO,CAAC;GACrD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../../src/system/scripts.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;GAON,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO;;;oBAGW,GAAG,CAAC,IAAI,CAAC;;;GAG1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;;;;;;GASN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAe,EAAE,KAAe;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxG,IAAI,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,EAAE,CAAC,CAAC;IAC7D,OAAO;;;2BAGkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;GAMxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO;;;;;GAKN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;GAUN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;GAeN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;GAkBN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,MAAe;IACnE,MAAM,UAAU,GAAG,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACrF,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO;;;yCAGgC,UAAU,KAAK,QAAQ;oDACZ,QAAQ;6CACf,GAAG,CAAC,IAAI,CAAC;GACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,KAAc,EAAE,QAAiB,EAAE,KAAc;IACvG,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,OAAO;;;+BAGsB,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;4CACrB,GAAG,CAAC,OAAO,CAAC;GACrD,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heznpc/imcp",
-  "version": "0.9.0",
+  "version": "1.1.0",
   "description": "MCP server for the entire Apple ecosystem — Notes, Reminders, Calendar, Contacts, Mail, Messages, Music, Finder, Safari, Photos, Shortcuts, System, and Apple Intelligence. Connect any AI to your Mac.",
   "keywords": [
     "mcp",
@@ -46,6 +46,7 @@
   },
   "license": "MIT",
   "author": "heznpc",
+  "mcpName": "io.github.heznpc/imcp",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -67,17 +68,19 @@
     "start": "node dist/index.js",
     "test": "node --experimental-vm-modules node_modules/.bin/jest",
     "typecheck": "tsc --noEmit",
-    "version:patch": "npm version patch --no-git-tag-version",
-    "version:minor": "npm version minor --no-git-tag-version",
-    "version:major": "npm version major --no-git-tag-version"
+    "version:patch": "npm version patch --no-git-tag-version && node -e \"let s=require('./server.json');s.version=s.packages[0].version=require('./package.json').version;require('fs').writeFileSync('server.json',JSON.stringify(s,null,2)+'\\n')\"",
+    "version:minor": "npm version minor --no-git-tag-version && node -e \"let s=require('./server.json');s.version=s.packages[0].version=require('./package.json').version;require('fs').writeFileSync('server.json',JSON.stringify(s,null,2)+'\\n')\"",
+    "version:major": "npm version major --no-git-tag-version && node -e \"let s=require('./server.json');s.version=s.packages[0].version=require('./package.json').version;require('fs').writeFileSync('server.json',JSON.stringify(s,null,2)+'\\n')\""
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "express": "^5.2.1",
     "zod": "^3.24.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@jest/globals": "^29.7.0",
+    "@types/express": "^5.0.6",
     "@types/node": "^22.0.0",
     "eslint": "^10.0.3",
     "globals": "^16.0.0",