mac-apps-launcher

Instructions

Implementation Reference

• utils/index.ts:18-28 (handler)

  The launchApp function implements the core logic to launch a Mac application using the 'open' command.

  export async function launchApp(appName: string): Promise<boolean> {
    try {
      const fullAppName = appName.endsWith(".app") ? appName : `${appName}.app`;
      const appPath = join("/Applications", fullAppName);
      await execAsync(`open "${appPath}"`);
      return true;
    } catch (error) {
      console.error("Error launching application:", error);
      return false;
    }
  }

• tools.ts:10-12 (schema)

  Zod input schema for the launch_app tool, requiring 'appName' as string.

  export const LaunchAppInputSchema = {
    appName: z.string(),
  };

• tools.ts:50-75 (registration)

  Tool configuration object for 'launch_app' including name, description, annotations, schema reference, and thin wrapper callback that invokes the launchApp utility.

  const launchAppConfig: ToolConfig<typeof LaunchAppInputSchema> = {
    name: "launch_app",
    description: "Launch a Mac application by name",
    annotations: {
      title: "啟動應用程式",
      readOnlyHint: false, // 會修改系統狀態(啟動應用程式)
      destructiveHint: false, // 不執行破壞性操作
      idempotentHint: false, // 重複啟動可能有不同結果
      openWorldHint: true, // 與外部應用程式互動
    },
    schema: LaunchAppInputSchema,
    cb: async (args) => {
      const success = await launchApp(args.appName);
      const toolResult: CallToolResult = {
        content: [
          {
            type: "text",
            text: success
              ? "Application launched successfully"
              : "Failed to launch application",
          },
        ],
      };
      return toolResult;
    },
  };

• tools.ts:103-107 (registration)

  Export of the tools array where launchAppConfig is registered alongside other tools for use in the MCP server.

  export const tools: ToolConfig<any>[] = [
    listApplicationsConfig,
    launchAppConfig,
    openWithAppConfig,
  ];