@ebowwa/osascript 1.1.0

package/src/mcp/index.ts

@@ -0,0 +1,565 @@
+#!/usr/bin/env bun
+/**
+ * osascript MCP Server (HTTP)
+ *
+ * Model Context Protocol server for macOS automation via osascript
+ * Uses HTTP transport for remote access
+ */
+
+import {
+  executeAppleScript,
+  executeJXA,
+  displayNotification,
+  displayDialog,
+  getVolume,
+  setVolume,
+  getClipboard,
+  setClipboard,
+  clearClipboard,
+  listRunningApplications,
+  getApplicationInfo,
+  activateApplication,
+  quitApplication,
+  launchApplication,
+  getFrontmostApplication,
+  getApplicationWindows,
+  setWindowBounds,
+  sendKeystroke,
+  sendKeyCode,
+  typeText,
+  getSafariURL,
+  setSafariURL,
+  getSafariTabTitles,
+  executeSafariJS,
+  getFinderSelection,
+  openFinderWindow,
+  createFolder,
+  moveToTrash,
+  getDisplayInfo,
+  getScreenResolution,
+  sayText,
+  beep,
+  getSystemDateTime,
+  isMacOS,
+} from "../index.js";
+
+import type { NotificationOptions, DialogOptions, KeystrokeOptions, KeyCodeOptions } from "../types.js";
+
+// ==============
+// Configuration
+// ==============
+
+const MCP_PORT = parseInt(process.env.MCP_PORT || "8914");
+
+// ==============
+// Tool Implementations
+// ==============
+
+async function osascriptExecute(
+  script: string,
+  language: "applescript" | "javascript" = "applescript"
+): Promise<string> {
+  const result = language === "javascript" ? await executeJXA(script) : await executeAppleScript(script);
+  return JSON.stringify(result, null, 2);
+}
+
+async function osascriptNotification(
+  message: string,
+  title: string = "Notification",
+  subtitle?: string,
+  soundName?: string
+): Promise<string> {
+  const options: NotificationOptions = { message, title, subtitle, soundName };
+  const result = await displayNotification(options);
+  return result.success ? `Notification sent: ${title}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptDialog(
+  message: string,
+  title?: string,
+  buttons?: string[],
+  defaultButton?: number,
+  icon?: "note" | "caution" | "stop"
+): Promise<string> {
+  const options: DialogOptions = { message, title, buttons, defaultButton, icon };
+  try {
+    const result = await displayDialog(options);
+    return `Button returned: ${result.buttonReturned}${result.gaveUp ? " (timed out)" : ""}`;
+  } catch (error) {
+    return `Error: ${error}`;
+  }
+}
+
+async function osascriptGetVolume(): Promise<string> {
+  const info = await getVolume();
+  return `Volume: ${info.volume}%${info.muted ? " (muted)" : ""}`;
+}
+
+async function osascriptSetVolume(volume: number, muted?: boolean): Promise<string> {
+  const result = await setVolume(volume, muted);
+  return result.success ? `Volume set to ${volume}%` : `Error: ${result.stderr}`;
+}
+
+async function osascriptGetClipboard(): Promise<string> {
+  try {
+    const content = await getClipboard();
+    return content || "(clipboard is empty)";
+  } catch (error) {
+    return `Error: ${error}`;
+  }
+}
+
+async function osascriptSetClipboard(text: string): Promise<string> {
+  const result = await setClipboard(text);
+  return result.success ? "Clipboard updated" : `Error: ${result.stderr}`;
+}
+
+async function osascriptClearClipboard(): Promise<string> {
+  const result = await clearClipboard();
+  return result.success ? "Clipboard cleared" : `Error: ${result.stderr}`;
+}
+
+async function osascriptListApps(): Promise<string> {
+  const apps = await listRunningApplications();
+  const lines = ["Running Applications:", "=".repeat(40), ""];
+  for (const app of apps) {
+    lines.push(`- ${app.name}`);
+  }
+  return lines.join("\n");
+}
+
+async function osascriptGetAppInfo(appName: string): Promise<string> {
+  const info = await getApplicationInfo(appName);
+  if (!info.running) {
+    return `Application "${appName}" is not running`;
+  }
+  const lines = [
+    `Application: ${info.name}`,
+    "=".repeat(40),
+    `Running: ${info.running}`,
+    info.path ? `Path: ${info.path}` : "",
+    info.processId ? `PID: ${info.processId}` : "",
+    info.windowCount !== undefined ? `Windows: ${info.windowCount}` : "",
+  ].filter(Boolean);
+  return lines.join("\n");
+}
+
+async function osascriptActivateApp(appName: string): Promise<string> {
+  const result = await activateApplication(appName);
+  return result.success ? `Activated ${appName}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptQuitApp(appName: string, force: boolean = false): Promise<string> {
+  const result = await quitApplication(appName, force);
+  return result.success ? `Quit ${appName}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptLaunchApp(appName: string): Promise<string> {
+  const result = await launchApplication(appName);
+  return result.success ? `Launched ${appName}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptGetFrontmostApp(): Promise<string> {
+  const appName = await getFrontmostApplication();
+  return `Frontmost application: ${appName}`;
+}
+
+async function osascriptGetWindows(appName: string): Promise<string> {
+  const windows = await getApplicationWindows(appName);
+  if (windows.length === 0) {
+    return `No windows for ${appName}`;
+  }
+  const lines = [`Windows for ${appName}:`, "=".repeat(40), ""];
+  for (const win of windows) {
+    lines.push(`${win.index}. ${win.name || "(unnamed)"} (ID: ${win.id})`);
+  }
+  return lines.join("\n");
+}
+
+async function osascriptSetWindowBounds(
+  appName: string,
+  windowIndex: number,
+  x: number,
+  y: number,
+  width: number,
+  height: number
+): Promise<string> {
+  const result = await setWindowBounds(appName, windowIndex, { x, y, width, height });
+  return result.success
+    ? `Window ${windowIndex} bounds set to ${width}x${height} at (${x}, ${y})`
+    : `Error: ${result.stderr}`;
+}
+
+function parseModifiers(modifiersStr?: string): ("command" | "shift" | "option" | "control")[] {
+  if (!modifiersStr) return [];
+  return modifiersStr
+    .split(",")
+    .map((m) => m.trim().toLowerCase() as "command" | "shift" | "option" | "control")
+    .filter((m) => ["command", "shift", "option", "control"].includes(m));
+}
+
+async function osascriptKeystroke(
+  key: string,
+  modifiers: ("command" | "shift" | "option" | "control")[] = []
+): Promise<string> {
+  const options: KeystrokeOptions = { key, modifiers };
+  const result = await sendKeystroke(options);
+  const modStr = modifiers.length > 0 ? ` with ${modifiers.join("+")}` : "";
+  return result.success ? `Sent keystroke: ${key}${modStr}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptKeyCode(
+  keyCode: number,
+  modifiers: ("command" | "shift" | "option" | "control")[] = []
+): Promise<string> {
+  const options: KeyCodeOptions = { keyCode, modifiers };
+  const result = await sendKeyCode(options);
+  const modStr = modifiers.length > 0 ? ` with ${modifiers.join("+")}` : "";
+  return result.success ? `Sent key code: ${keyCode}${modStr}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptTypeText(text: string): Promise<string> {
+  const result = await typeText(text);
+  return result.success ? `Typed: ${text}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptSafariGetURL(): Promise<string> {
+  try {
+    const url = await getSafariURL();
+    return `Current Safari URL: ${url}`;
+  } catch (error) {
+    return `Error: ${error}`;
+  }
+}
+
+async function osascriptSafariSetURL(url: string): Promise<string> {
+  const result = await setSafariURL(url);
+  return result.success ? `Navigated to: ${url}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptSafariGetTabs(): Promise<string> {
+  const titles = await getSafariTabTitles();
+  if (titles.length === 0) {
+    return "No Safari tabs";
+  }
+  const lines = ["Safari Tabs:", "=".repeat(40), ""];
+  titles.forEach((title, i) => lines.push(`${i + 1}. ${title}`));
+  return lines.join("\n");
+}
+
+async function osascriptSafariExecJS(jsCode: string): Promise<string> {
+  try {
+    const result = await executeSafariJS(jsCode);
+    return result || "(no output)";
+  } catch (error) {
+    return `Error: ${error}`;
+  }
+}
+
+async function osascriptFinderGetSelection(): Promise<string> {
+  const items = await getFinderSelection();
+  if (items.length === 0) {
+    return "No Finder selection";
+  }
+  const lines = ["Finder Selection:", "=".repeat(40), ""];
+  for (const item of items) {
+    lines.push(`- ${item.name} (${item.type})`);
+    lines.push(`  ${item.path}`);
+  }
+  return lines.join("\n");
+}
+
+async function osascriptFinderOpen(path: string): Promise<string> {
+  const result = await openFinderWindow(path);
+  return result.success ? `Opened Finder at: ${path}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptFinderCreateFolder(parentPath: string, folderName: string): Promise<string> {
+  const result = await createFolder(parentPath, folderName);
+  return result.success ? `Created folder: ${folderName}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptFinderTrash(path: string): Promise<string> {
+  const result = await moveToTrash(path);
+  return result.success ? `Moved to trash: ${path}` : `Error: ${result.stderr}`;
+}
+
+async function osascriptGetDisplays(): Promise<string> {
+  const displays = await getDisplayInfo();
+  const lines = ["Display Information:", "=".repeat(40), ""];
+  for (const display of displays) {
+    lines.push(`Display ${display.id}: ${display.width}x${display.height}${display.main ? " (main)" : ""}`);
+  }
+  return lines.join("\n");
+}
+
+async function osascriptGetResolution(): Promise<string> {
+  const { width, height } = await getScreenResolution();
+  return `Screen resolution: ${width}x${height}`;
+}
+
+async function osascriptSay(text: string, voice?: string, rate?: number): Promise<string> {
+  const result = await sayText(text, voice, rate);
+  return result.success ? `Said: "${text}"` : `Error: ${result.stderr}`;
+}
+
+async function osascriptBeep(count: number = 1): Promise<string> {
+  const result = await beep(count);
+  return result.success ? `Beeped ${count} time(s)` : `Error: ${result.stderr}`;
+}
+
+async function osascriptGetDateTime(): Promise<string> {
+  const dateTime = await getSystemDateTime();
+  return `System date/time: ${dateTime}`;
+}
+
+// ==============
+// Tool Definitions
+// ==============
+
+const TOOLS = [
+  // Core
+  { name: "osascript_execute", description: "Execute raw AppleScript or JXA code", args: ["script", "language?"] },
+  // System
+  { name: "osascript_display_notification", description: "Display a macOS notification", args: ["message", "title?", "subtitle?", "sound_name?"] },
+  { name: "osascript_display_dialog", description: "Display a dialog with buttons", args: ["message", "title?", "buttons?", "default_button?", "icon?"] },
+  // Volume
+  { name: "osascript_get_volume", description: "Get system volume level", args: [] },
+  { name: "osascript_set_volume", description: "Set system volume level (0-100)", args: ["volume", "muted?"] },
+  // Clipboard
+  { name: "osascript_get_clipboard", description: "Get clipboard contents", args: [] },
+  { name: "osascript_set_clipboard", description: "Set clipboard contents", args: ["text"] },
+  { name: "osascript_clear_clipboard", description: "Clear clipboard contents", args: [] },
+  // Applications
+  { name: "osascript_list_apps", description: "List all running applications", args: [] },
+  { name: "osascript_get_app_info", description: "Get detailed information about an application", args: ["app_name"] },
+  { name: "osascript_activate_app", description: "Activate (bring to front) an application", args: ["app_name"] },
+  { name: "osascript_quit_app", description: "Quit an application", args: ["app_name", "force?"] },
+  { name: "osascript_launch_app", description: "Launch an application", args: ["app_name"] },
+  { name: "osascript_get_frontmost_app", description: "Get the name of the frontmost application", args: [] },
+  // Windows
+  { name: "osascript_get_windows", description: "Get window list for an application", args: ["app_name"] },
+  { name: "osascript_set_window_bounds", description: "Set window position and size", args: ["app_name", "window_index", "x", "y", "width", "height"] },
+  // Keyboard
+  { name: "osascript_keystroke", description: "Send keystroke with optional modifiers", args: ["key", "modifiers?"] },
+  { name: "osascript_key_code", description: "Send key code (for special keys)", args: ["key_code", "modifiers?"] },
+  { name: "osascript_type_text", description: "Type text (simulate keyboard input)", args: ["text"] },
+  // Safari
+  { name: "osascript_safari_get_url", description: "Get current Safari URL", args: [] },
+  { name: "osascript_safari_set_url", description: "Navigate Safari to URL", args: ["url"] },
+  { name: "osascript_safari_get_tabs", description: "Get Safari tab titles", args: [] },
+  { name: "osascript_safari_exec_js", description: "Execute JavaScript in Safari", args: ["js_code"] },
+  // Finder
+  { name: "osascript_finder_get_selection", description: "Get currently selected files in Finder", args: [] },
+  { name: "osascript_finder_open", description: "Open Finder window at path", args: ["path"] },
+  { name: "osascript_finder_create_folder", description: "Create new folder in Finder", args: ["parent_path", "folder_name"] },
+  { name: "osascript_finder_trash", description: "Move file/folder to trash", args: ["path"] },
+  // Display
+  { name: "osascript_get_displays", description: "Get display information", args: [] },
+  { name: "osascript_get_resolution", description: "Get main screen resolution", args: [] },
+  // Audio
+  { name: "osascript_say", description: "Say text using system voice", args: ["text", "voice?", "rate?"] },
+  { name: "osascript_beep", description: "Play system beep", args: ["count?"] },
+  // Date/Time
+  { name: "osascript_get_datetime", description: "Get current system date/time", args: [] },
+];
+
+// ==============
+// HTTP Server
+// ==============
+
+Bun.serve({
+  port: MCP_PORT,
+  fetch: async (req: Request) => {
+    const url = new URL(req.url);
+
+    // Health check
+    if (url.pathname === "/health") {
+      return Response.json({
+        status: "ok",
+        port: MCP_PORT,
+        service: "osascript-mcp",
+        platform: process.platform,
+        macos: isMacOS(),
+      });
+    }
+
+    // MCP endpoint
+    if (url.pathname === "/mcp") {
+      if (req.method === "GET") {
+        // Return available tools
+        return Response.json({
+          name: "osascript-mcp",
+          version: "1.0.0",
+          description: "macOS automation via osascript (AppleScript/JXA)",
+          platform: process.platform,
+          macos: isMacOS(),
+          tools: TOOLS,
+        });
+      }
+
+      if (req.method === "POST") {
+        // Verify macOS
+        if (!isMacOS()) {
+          return Response.json({ error: "osascript MCP only works on macOS" }, { status: 500 });
+        }
+
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const body = (await req.json()) as any;
+        const { tool, args = {} } = body;
+
+        try {
+          let result: string;
+
+          switch (tool) {
+            // Core
+            case "osascript_execute":
+              result = await osascriptExecute(args?.script, args?.language || "applescript");
+              break;
+
+            // System
+            case "osascript_display_notification":
+              result = await osascriptNotification(args?.message, args?.title, args?.subtitle, args?.sound_name);
+              break;
+            case "osascript_display_dialog":
+              result = await osascriptDialog(
+                args?.message,
+                args?.title,
+                args?.buttons?.split(","),
+                args?.default_button,
+                args?.icon
+              );
+              break;
+
+            // Volume
+            case "osascript_get_volume":
+              result = await osascriptGetVolume();
+              break;
+            case "osascript_set_volume":
+              result = await osascriptSetVolume(args?.volume, args?.muted);
+              break;
+
+            // Clipboard
+            case "osascript_get_clipboard":
+              result = await osascriptGetClipboard();
+              break;
+            case "osascript_set_clipboard":
+              result = await osascriptSetClipboard(args?.text);
+              break;
+            case "osascript_clear_clipboard":
+              result = await osascriptClearClipboard();
+              break;
+
+            // Applications
+            case "osascript_list_apps":
+              result = await osascriptListApps();
+              break;
+            case "osascript_get_app_info":
+              result = await osascriptGetAppInfo(args?.app_name);
+              break;
+            case "osascript_activate_app":
+              result = await osascriptActivateApp(args?.app_name);
+              break;
+            case "osascript_quit_app":
+              result = await osascriptQuitApp(args?.app_name, args?.force);
+              break;
+            case "osascript_launch_app":
+              result = await osascriptLaunchApp(args?.app_name);
+              break;
+            case "osascript_get_frontmost_app":
+              result = await osascriptGetFrontmostApp();
+              break;
+
+            // Windows
+            case "osascript_get_windows":
+              result = await osascriptGetWindows(args?.app_name);
+              break;
+            case "osascript_set_window_bounds":
+              result = await osascriptSetWindowBounds(
+                args?.app_name,
+                args?.window_index,
+                args?.x,
+                args?.y,
+                args?.width,
+                args?.height
+              );
+              break;
+
+            // Keyboard
+            case "osascript_keystroke":
+              result = await osascriptKeystroke(args?.key, parseModifiers(args?.modifiers));
+              break;
+            case "osascript_key_code":
+              result = await osascriptKeyCode(args?.key_code, parseModifiers(args?.modifiers));
+              break;
+            case "osascript_type_text":
+              result = await osascriptTypeText(args?.text);
+              break;
+
+            // Safari
+            case "osascript_safari_get_url":
+              result = await osascriptSafariGetURL();
+              break;
+            case "osascript_safari_set_url":
+              result = await osascriptSafariSetURL(args?.url);
+              break;
+            case "osascript_safari_get_tabs":
+              result = await osascriptSafariGetTabs();
+              break;
+            case "osascript_safari_exec_js":
+              result = await osascriptSafariExecJS(args?.js_code);
+              break;
+
+            // Finder
+            case "osascript_finder_get_selection":
+              result = await osascriptFinderGetSelection();
+              break;
+            case "osascript_finder_open":
+              result = await osascriptFinderOpen(args?.path);
+              break;
+            case "osascript_finder_create_folder":
+              result = await osascriptFinderCreateFolder(args?.parent_path, args?.folder_name);
+              break;
+            case "osascript_finder_trash":
+              result = await osascriptFinderTrash(args?.path);
+              break;
+
+            // Display
+            case "osascript_get_displays":
+              result = await osascriptGetDisplays();
+              break;
+            case "osascript_get_resolution":
+              result = await osascriptGetResolution();
+              break;
+
+            // Audio
+            case "osascript_say":
+              result = await osascriptSay(args?.text, args?.voice, args?.rate);
+              break;
+            case "osascript_beep":
+              result = await osascriptBeep(args?.count || 1);
+              break;
+
+            // Date/Time
+            case "osascript_get_datetime":
+              result = await osascriptGetDateTime();
+              break;
+
+            default:
+              return Response.json({ error: `Unknown tool: ${tool}` }, { status: 400 });
+          }
+
+          return Response.json({ result });
+        } catch (error) {
+          return Response.json({ error: String(error) }, { status: 500 });
+        }
+      }
+    }
+
+    return Response.json({ error: "Not found" }, { status: 404 });
+  },
+});
+
+console.log(`osascript MCP Server running on port ${MCP_PORT}`);
+console.log(`   Health: http://localhost:${MCP_PORT}/health`);
+console.log(`   MCP:    http://localhost:${MCP_PORT}/mcp`);