mac-apps-launcher

Instructions

Implementation Reference

• utils/index.ts:30-43 (handler)

  Implements the core logic to open a file with a specified macOS application using the 'open -a' command.

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

• tools.ts:14-17 (schema)

  Zod schema for input validation of the open_with_app tool.

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

• tools.ts:76-101 (registration)

  Registers the open_with_app tool with name, description, annotations, schema reference, and callback that invokes the handler.

  const openWithAppConfig: ToolConfig<typeof OpenWithAppInputSchema> = {
    name: "open_with_app",
    description: "Open a file or folder with a specific application",
    annotations: {
      title: "用應用程式開啟檔案",
      readOnlyHint: false, // 會修改系統狀態
      destructiveHint: false, // 不執行破壞性操作
      idempotentHint: false, // 重複開啟可能有不同結果
      openWorldHint: true, // 與外部應用程式和檔案互動
    },
    schema: OpenWithAppInputSchema,
    cb: async (args) => {
      const success = await openWithApp(args.appName, args.filePath);
      const toolResult: CallToolResult = {
        content: [
          {
            type: "text",
            text: success
              ? "File opened successfully"
              : "Failed to open file with application",
          },
        ],
      };
      return toolResult;
    },
  };