@goforgeit/mcp-macos-automation 0.5.2

package/LICENSE

@@ -0,0 +1,50 @@
+Forge
+Copyright (c) 2025 Prometheus Group LLC. All Rights Reserved.
+
+PROPRIETARY LICENSE
+
+This software and associated documentation files (the "Software") are the 
+exclusive property of Prometheus Group LLC. The Software is protected by 
+copyright laws and international treaty provisions.
+
+GRANT OF ACCESS
+
+Access to this Software is granted solely for the purpose of evaluation, 
+testing, and providing feedback to Prometheus Group LLC. This access does 
+not constitute a transfer of ownership, license to use commercially, or 
+any other rights not expressly stated herein.
+
+RESTRICTIONS
+
+You may NOT:
+- Use the Software for commercial purposes without explicit written permission
+- Copy, modify, merge, publish, distribute, sublicense, or sell copies of the Software
+- Reverse engineer, decompile, or disassemble the Software
+- Remove or alter any proprietary notices, labels, or marks on the Software
+- Claim ownership or authorship of the Software or any derivative works
+
+FEEDBACK
+
+Any feedback, suggestions, ideas, or improvements you provide regarding the 
+Software shall become the exclusive property of Prometheus Group LLC. You 
+hereby assign all rights, title, and interest in such feedback to Prometheus 
+Group LLC without any obligation of compensation or attribution.
+
+NO WARRANTY
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
+PROMETHEUS GROUP LLC BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF 
+OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+TERMINATION
+
+This access may be terminated at any time by Prometheus Group LLC without 
+prior notice. Upon termination, you must destroy all copies of the Software 
+in your possession.
+
+CONTACT
+
+For licensing inquiries, please visit: https://goforgeit.com

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+/**
+ * @goforgeit/mcp-macos-automation
+ *
+ * Forge MCP server for macOS automation.
+ * Provides general AppleScript/JXA execution, plus dedicated tools
+ * for Microsoft PowerPoint and Microsoft Word via osascript.
+ */
+
+interface MacOSAutomationMCPServer {
+    server: McpServer;
+    getRegisteredTools(): string[];
+    start(): Promise<void>;
+}
+declare function runAppleScript(script: string, timeout?: number): Promise<string>;
+declare function createMacOSAutomationMCPServer(): MacOSAutomationMCPServer;
+
+export { type MacOSAutomationMCPServer, createMacOSAutomationMCPServer, runAppleScript };

package/dist/index.js

@@ -0,0 +1,406 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { execFile } from "child_process";
+import { promisify } from "util";
+var execFileAsync = promisify(execFile);
+var OSASCRIPT_TIMEOUT = 3e4;
+var MAX_BUFFER = 1024 * 1024;
+async function runAppleScript(script, timeout = OSASCRIPT_TIMEOUT) {
+  const { stdout } = await execFileAsync("osascript", ["-e", script], {
+    timeout,
+    maxBuffer: MAX_BUFFER
+  });
+  return stdout.trim();
+}
+async function runJxa(script, timeout = OSASCRIPT_TIMEOUT) {
+  const { stdout } = await execFileAsync("osascript", ["-l", "JavaScript", "-e", script], {
+    timeout,
+    maxBuffer: MAX_BUFFER
+  });
+  return stdout.trim();
+}
+function createMacOSAutomationMCPServer() {
+  const server = new McpServer({
+    name: "@goforgeit/mcp-macos-automation",
+    version: "0.1.0"
+  });
+  const registeredTools = [];
+  server.tool(
+    "run_applescript",
+    "Execute arbitrary AppleScript code via osascript. Returns the script output as text.",
+    {
+      script: z.string().describe("The AppleScript code to execute"),
+      timeout: z.number().optional().default(OSASCRIPT_TIMEOUT).describe("Execution timeout in milliseconds (default: 30000)")
+    },
+    async ({ script, timeout }) => {
+      try {
+        const result = await runAppleScript(script, timeout);
+        return { content: [{ type: "text", text: result }] };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `AppleScript error: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  registeredTools.push("run_applescript");
+  server.tool(
+    "run_jxa",
+    "Execute JavaScript for Automation (JXA) code via osascript -l JavaScript. Returns the script output as text.",
+    {
+      script: z.string().describe("The JXA (JavaScript for Automation) code to execute"),
+      timeout: z.number().optional().default(OSASCRIPT_TIMEOUT).describe("Execution timeout in milliseconds (default: 30000)")
+    },
+    async ({ script, timeout }) => {
+      try {
+        const result = await runJxa(script, timeout);
+        return { content: [{ type: "text", text: result }] };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `JXA error: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  registeredTools.push("run_jxa");
+  server.tool(
+    "list_presentations",
+    "List all currently open Microsoft PowerPoint presentations with their names and slide counts",
+    {},
+    async () => {
+      const script = `
+        tell application "Microsoft PowerPoint"
+          set output to "["
+          set isFirst to true
+          repeat with pres in presentations
+            if not isFirst then
+              set output to output & ","
+            end if
+            set presName to name of pres
+            set slideCount to count of slides of pres
+            set output to output & "{\\"name\\":\\"" & presName & "\\",\\"slides\\":" & slideCount & "}"
+            set isFirst to false
+          end repeat
+          return output & "]"
+        end tell
+      `;
+      try {
+        const result = await runAppleScript(script);
+        return { content: [{ type: "text", text: result }] };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to list presentations: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  registeredTools.push("list_presentations");
+  server.tool(
+    "get_slide_content",
+    "Read text content and notes from a specific slide in the active PowerPoint presentation",
+    {
+      slide_number: z.number().describe("Slide number (1-indexed)")
+    },
+    async ({ slide_number }) => {
+      const script = `
+        tell application "Microsoft PowerPoint"
+          if (count of presentations) = 0 then
+            return "No presentation is open"
+          end if
+          set activePres to active presentation
+          set targetSlide to slide ${slide_number} of activePres
+          set slideText to ""
+          repeat with shp in shapes of targetSlide
+            if has text frame shp then
+              set slideText to slideText & (content of text range of text frame of shp) & return
+            end if
+          end repeat
+          return slideText
+        end tell
+      `;
+      try {
+        const result = await runAppleScript(script);
+        return { content: [{ type: "text", text: result }] };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to get slide content: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  registeredTools.push("get_slide_content");
+  server.tool(
+    "create_presentation",
+    "Create a new PowerPoint presentation with a title slide",
+    {
+      title: z.string().optional().describe("Title for the first slide")
+    },
+    async ({ title }) => {
+      const titlePart = title ? `
+            set targetSlide to slide 1 of activePres
+            set content of text range of text frame of shape 1 of targetSlide to ${JSON.stringify(title)}` : "";
+      const script = `
+        tell application "Microsoft PowerPoint"
+          activate
+          set activePres to make new presentation
+          ${titlePart}
+          return "New presentation created successfully"
+        end tell
+      `;
+      try {
+        const result = await runAppleScript(script);
+        return { content: [{ type: "text", text: result }] };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to create presentation: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  registeredTools.push("create_presentation");
+  server.tool(
+    "add_slide",
+    "Add a new slide with optional content to an open PowerPoint presentation",
+    {
+      title: z.string().optional().describe("Slide title text"),
+      body: z.string().optional().describe("Slide body text"),
+      layout: z.enum(["title", "title_content", "blank"]).optional().default("title_content").describe("Slide layout type")
+    },
+    async ({ title, body, layout }) => {
+      const layoutMap = {
+        title: "slide layout title slide",
+        title_content: "slide layout title only",
+        blank: "slide layout blank"
+      };
+      const pptLayout = layoutMap[layout];
+      const titlePart = title ? `set content of text range of text frame of shape 1 of newSlide to ${JSON.stringify(title)}` : "";
+      const bodyPart = body ? `set content of text range of text frame of shape 2 of newSlide to ${JSON.stringify(body)}` : "";
+      const script = `
+        tell application "Microsoft PowerPoint"
+          if (count of presentations) = 0 then
+            return "No presentation is open"
+          end if
+          set activePres to active presentation
+          set newSlide to make new slide at end of activePres with properties {slide layout:${pptLayout}}
+          ${titlePart}
+          ${bodyPart}
+          return "Slide added successfully"
+        end tell
+      `;
+      try {
+        const result = await runAppleScript(script);
+        return { content: [{ type: "text", text: result }] };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to add slide: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  registeredTools.push("add_slide");
+  server.tool(
+    "list_documents",
+    "List all currently open Microsoft Word documents with their names",
+    {},
+    async () => {
+      const script = `
+        tell application "Microsoft Word"
+          set output to "["
+          set isFirst to true
+          repeat with doc in documents
+            if not isFirst then
+              set output to output & ","
+            end if
+            set docName to name of doc
+            set output to output & "{\\"name\\":\\"" & docName & "\\"}"
+            set isFirst to false
+          end repeat
+          return output & "]"
+        end tell
+      `;
+      try {
+        const result = await runAppleScript(script);
+        return { content: [{ type: "text", text: result }] };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to list documents: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  registeredTools.push("list_documents");
+  server.tool(
+    "get_document_content",
+    "Read all text content from the active Microsoft Word document",
+    {},
+    async () => {
+      const script = `
+        tell application "Microsoft Word"
+          if (count of documents) = 0 then
+            return "No document is open"
+          end if
+          set activeDoc to active document
+          return content of text object of activeDoc as string
+        end tell
+      `;
+      try {
+        const result = await runAppleScript(script);
+        return { content: [{ type: "text", text: result }] };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to get document content: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  registeredTools.push("get_document_content");
+  server.tool(
+    "create_document",
+    "Create a new Microsoft Word document with optional initial content",
+    {
+      content: z.string().optional().describe("Initial text content for the document")
+    },
+    async ({ content: docContent }) => {
+      const contentPart = docContent ? `
+            tell newDoc
+              set content of text object to ${JSON.stringify(docContent)}
+            end tell` : "";
+      const script = `
+        tell application "Microsoft Word"
+          activate
+          set newDoc to make new document
+          ${contentPart}
+          return "New document created successfully"
+        end tell
+      `;
+      try {
+        const result = await runAppleScript(script);
+        return { content: [{ type: "text", text: result }] };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to create document: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  registeredTools.push("create_document");
+  server.tool(
+    "search_in_document",
+    "Find text in the active Microsoft Word document. Returns whether the text was found.",
+    {
+      query: z.string().describe("Text to search for in the document")
+    },
+    async ({ query }) => {
+      const script = `
+        tell application "Microsoft Word"
+          if (count of documents) = 0 then
+            return "No document is open"
+          end if
+          set activeDoc to active document
+          set docText to content of text object of activeDoc as string
+          if docText contains ${JSON.stringify(query)} then
+            return "Found: " & ${JSON.stringify(query)}
+          else
+            return "Not found: " & ${JSON.stringify(query)}
+          end if
+        end tell
+      `;
+      try {
+        const result = await runAppleScript(script);
+        return { content: [{ type: "text", text: result }] };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to search document: ${error instanceof Error ? error.message : String(error)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  registeredTools.push("search_in_document");
+  return {
+    server,
+    getRegisteredTools() {
+      return [...registeredTools];
+    },
+    async start() {
+      const transport = new StdioServerTransport();
+      await server.connect(transport);
+    }
+  };
+}
+var isMainModule = process.argv[1] && import.meta.url.endsWith(process.argv[1].replace(/\\/g, "/"));
+if (isMainModule || process.env.FORGE_MCP_START === "true") {
+  const mcpServer = createMacOSAutomationMCPServer();
+  mcpServer.start().catch((err) => {
+    console.error("Failed to start macOS Automation MCP server:", err);
+    process.exit(1);
+  });
+}
+export {
+  createMacOSAutomationMCPServer,
+  runAppleScript
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @goforgeit/mcp-macos-automation\n *\n * Forge MCP server for macOS automation.\n * Provides general AppleScript/JXA execution, plus dedicated tools\n * for Microsoft PowerPoint and Microsoft Word via osascript.\n */\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod';\nimport { execFile } from 'child_process';\nimport { promisify } from 'util';\n\nconst execFileAsync = promisify(execFile);\n\nconst OSASCRIPT_TIMEOUT = 30000;\nconst MAX_BUFFER = 1024 * 1024;\n\nexport interface MacOSAutomationMCPServer {\n  server: McpServer;\n  getRegisteredTools(): string[];\n  start(): Promise<void>;\n}\n\nexport async function runAppleScript(script: string, timeout = OSASCRIPT_TIMEOUT): Promise<string> {\n  const { stdout } = await execFileAsync('osascript', ['-e', script], {\n    timeout,\n    maxBuffer: MAX_BUFFER,\n  });\n  return stdout.trim();\n}\n\nasync function runJxa(script: string, timeout = OSASCRIPT_TIMEOUT): Promise<string> {\n  const { stdout } = await execFileAsync('osascript', ['-l', 'JavaScript', '-e', script], {\n    timeout,\n    maxBuffer: MAX_BUFFER,\n  });\n  return stdout.trim();\n}\n\nexport function createMacOSAutomationMCPServer(): MacOSAutomationMCPServer {\n  const server = new McpServer({\n    name: '@goforgeit/mcp-macos-automation',\n    version: '0.1.0',\n  });\n\n  const registeredTools: string[] = [];\n\n  // ============================================================\n  // General AppleScript Tools\n  // ============================================================\n\n  // --- run_applescript ---\n  server.tool(\n    'run_applescript',\n    'Execute arbitrary AppleScript code via osascript. Returns the script output as text.',\n    {\n      script: z.string().describe('The AppleScript code to execute'),\n      timeout: z\n        .number()\n        .optional()\n        .default(OSASCRIPT_TIMEOUT)\n        .describe('Execution timeout in milliseconds (default: 30000)'),\n    },\n    async ({ script, timeout }) => {\n      try {\n        const result = await runAppleScript(script, timeout);\n        return { content: [{ type: 'text' as const, text: result }] };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: `AppleScript error: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    },\n  );\n  registeredTools.push('run_applescript');\n\n  // --- run_jxa ---\n  server.tool(\n    'run_jxa',\n    'Execute JavaScript for Automation (JXA) code via osascript -l JavaScript. Returns the script output as text.',\n    {\n      script: z.string().describe('The JXA (JavaScript for Automation) code to execute'),\n      timeout: z\n        .number()\n        .optional()\n        .default(OSASCRIPT_TIMEOUT)\n        .describe('Execution timeout in milliseconds (default: 30000)'),\n    },\n    async ({ script, timeout }) => {\n      try {\n        const result = await runJxa(script, timeout);\n        return { content: [{ type: 'text' as const, text: result }] };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: `JXA error: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    },\n  );\n  registeredTools.push('run_jxa');\n\n  // ============================================================\n  // PowerPoint Tools\n  // ============================================================\n\n  // --- list_presentations ---\n  server.tool(\n    'list_presentations',\n    'List all currently open Microsoft PowerPoint presentations with their names and slide counts',\n    {},\n    async () => {\n      const script = `\n        tell application \"Microsoft PowerPoint\"\n          set output to \"[\"\n          set isFirst to true\n          repeat with pres in presentations\n            if not isFirst then\n              set output to output & \",\"\n            end if\n            set presName to name of pres\n            set slideCount to count of slides of pres\n            set output to output & \"{\\\\\"name\\\\\":\\\\\"\" & presName & \"\\\\\",\\\\\"slides\\\\\":\" & slideCount & \"}\"\n            set isFirst to false\n          end repeat\n          return output & \"]\"\n        end tell\n      `;\n      try {\n        const result = await runAppleScript(script);\n        return { content: [{ type: 'text' as const, text: result }] };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Failed to list presentations: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    },\n  );\n  registeredTools.push('list_presentations');\n\n  // --- get_slide_content ---\n  server.tool(\n    'get_slide_content',\n    'Read text content and notes from a specific slide in the active PowerPoint presentation',\n    {\n      slide_number: z.number().describe('Slide number (1-indexed)'),\n    },\n    async ({ slide_number }) => {\n      const script = `\n        tell application \"Microsoft PowerPoint\"\n          if (count of presentations) = 0 then\n            return \"No presentation is open\"\n          end if\n          set activePres to active presentation\n          set targetSlide to slide ${slide_number} of activePres\n          set slideText to \"\"\n          repeat with shp in shapes of targetSlide\n            if has text frame shp then\n              set slideText to slideText & (content of text range of text frame of shp) & return\n            end if\n          end repeat\n          return slideText\n        end tell\n      `;\n      try {\n        const result = await runAppleScript(script);\n        return { content: [{ type: 'text' as const, text: result }] };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Failed to get slide content: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    },\n  );\n  registeredTools.push('get_slide_content');\n\n  // --- create_presentation ---\n  server.tool(\n    'create_presentation',\n    'Create a new PowerPoint presentation with a title slide',\n    {\n      title: z.string().optional().describe('Title for the first slide'),\n    },\n    async ({ title }) => {\n      const titlePart = title\n        ? `\n            set targetSlide to slide 1 of activePres\n            set content of text range of text frame of shape 1 of targetSlide to ${JSON.stringify(title)}`\n        : '';\n\n      const script = `\n        tell application \"Microsoft PowerPoint\"\n          activate\n          set activePres to make new presentation\n          ${titlePart}\n          return \"New presentation created successfully\"\n        end tell\n      `;\n      try {\n        const result = await runAppleScript(script);\n        return { content: [{ type: 'text' as const, text: result }] };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Failed to create presentation: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    },\n  );\n  registeredTools.push('create_presentation');\n\n  // --- add_slide ---\n  server.tool(\n    'add_slide',\n    'Add a new slide with optional content to an open PowerPoint presentation',\n    {\n      title: z.string().optional().describe('Slide title text'),\n      body: z.string().optional().describe('Slide body text'),\n      layout: z\n        .enum(['title', 'title_content', 'blank'])\n        .optional()\n        .default('title_content')\n        .describe('Slide layout type'),\n    },\n    async ({ title, body, layout }) => {\n      const layoutMap: Record<string, string> = {\n        title: 'slide layout title slide',\n        title_content: 'slide layout title only',\n        blank: 'slide layout blank',\n      };\n      const pptLayout = layoutMap[layout];\n\n      const titlePart = title\n        ? `set content of text range of text frame of shape 1 of newSlide to ${JSON.stringify(title)}`\n        : '';\n      const bodyPart = body\n        ? `set content of text range of text frame of shape 2 of newSlide to ${JSON.stringify(body)}`\n        : '';\n\n      const script = `\n        tell application \"Microsoft PowerPoint\"\n          if (count of presentations) = 0 then\n            return \"No presentation is open\"\n          end if\n          set activePres to active presentation\n          set newSlide to make new slide at end of activePres with properties {slide layout:${pptLayout}}\n          ${titlePart}\n          ${bodyPart}\n          return \"Slide added successfully\"\n        end tell\n      `;\n      try {\n        const result = await runAppleScript(script);\n        return { content: [{ type: 'text' as const, text: result }] };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Failed to add slide: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    },\n  );\n  registeredTools.push('add_slide');\n\n  // ============================================================\n  // Word Tools\n  // ============================================================\n\n  // --- list_documents ---\n  server.tool(\n    'list_documents',\n    'List all currently open Microsoft Word documents with their names',\n    {},\n    async () => {\n      const script = `\n        tell application \"Microsoft Word\"\n          set output to \"[\"\n          set isFirst to true\n          repeat with doc in documents\n            if not isFirst then\n              set output to output & \",\"\n            end if\n            set docName to name of doc\n            set output to output & \"{\\\\\"name\\\\\":\\\\\"\" & docName & \"\\\\\"}\"\n            set isFirst to false\n          end repeat\n          return output & \"]\"\n        end tell\n      `;\n      try {\n        const result = await runAppleScript(script);\n        return { content: [{ type: 'text' as const, text: result }] };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Failed to list documents: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    },\n  );\n  registeredTools.push('list_documents');\n\n  // --- get_document_content ---\n  server.tool(\n    'get_document_content',\n    'Read all text content from the active Microsoft Word document',\n    {},\n    async () => {\n      const script = `\n        tell application \"Microsoft Word\"\n          if (count of documents) = 0 then\n            return \"No document is open\"\n          end if\n          set activeDoc to active document\n          return content of text object of activeDoc as string\n        end tell\n      `;\n      try {\n        const result = await runAppleScript(script);\n        return { content: [{ type: 'text' as const, text: result }] };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Failed to get document content: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    },\n  );\n  registeredTools.push('get_document_content');\n\n  // --- create_document ---\n  server.tool(\n    'create_document',\n    'Create a new Microsoft Word document with optional initial content',\n    {\n      content: z.string().optional().describe('Initial text content for the document'),\n    },\n    async ({ content: docContent }) => {\n      const contentPart = docContent\n        ? `\n            tell newDoc\n              set content of text object to ${JSON.stringify(docContent)}\n            end tell`\n        : '';\n\n      const script = `\n        tell application \"Microsoft Word\"\n          activate\n          set newDoc to make new document\n          ${contentPart}\n          return \"New document created successfully\"\n        end tell\n      `;\n      try {\n        const result = await runAppleScript(script);\n        return { content: [{ type: 'text' as const, text: result }] };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Failed to create document: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    },\n  );\n  registeredTools.push('create_document');\n\n  // --- search_in_document ---\n  server.tool(\n    'search_in_document',\n    'Find text in the active Microsoft Word document. Returns whether the text was found.',\n    {\n      query: z.string().describe('Text to search for in the document'),\n    },\n    async ({ query }) => {\n      const script = `\n        tell application \"Microsoft Word\"\n          if (count of documents) = 0 then\n            return \"No document is open\"\n          end if\n          set activeDoc to active document\n          set docText to content of text object of activeDoc as string\n          if docText contains ${JSON.stringify(query)} then\n            return \"Found: \" & ${JSON.stringify(query)}\n          else\n            return \"Not found: \" & ${JSON.stringify(query)}\n          end if\n        end tell\n      `;\n      try {\n        const result = await runAppleScript(script);\n        return { content: [{ type: 'text' as const, text: result }] };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: `Failed to search document: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    },\n  );\n  registeredTools.push('search_in_document');\n\n  return {\n    server,\n    getRegisteredTools() {\n      return [...registeredTools];\n    },\n    async start() {\n      const transport = new StdioServerTransport();\n      await server.connect(transport);\n    },\n  };\n}\n\n// CLI entry point\nconst isMainModule =\n  process.argv[1] && import.meta.url.endsWith(process.argv[1].replace(/\\\\/g, '/'));\n\nif (isMainModule || process.env.FORGE_MCP_START === 'true') {\n  const mcpServer = createMacOSAutomationMCPServer();\n  mcpServer.start().catch((err) => {\n    console.error('Failed to start macOS Automation MCP server:', err);\n    process.exit(1);\n  });\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@goforgeit/mcp-macos-automation",
+  "version": "0.5.2",
+  "type": "module",
+  "description": "Forge MCP server for macOS automation — AppleScript, JXA, Microsoft PowerPoint, and Microsoft Word via osascript",
+  "bin": {
+    "mcp-macos-automation": "./dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsup": "^8.0.0",
+    "vitest": "^3.2.4"
+  },
+  "os": [
+    "darwin"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}