applescript-mcp

Instructions

Implementation Reference

• src/categories/finder.ts:15-37 (handler)

  AppleScript handler implementation for the 'get_selected_files' script in the 'finder' category, executed as the tool 'finder_get_selected_files'.

  {
    name: "get_selected_files",
    description: "Get currently selected files in Finder",
    script: `
      tell application "Finder"
        try
          set selectedItems to selection
          if selectedItems is {} then
            return "No items selected"
          end if
  
          set itemPaths to ""
          repeat with theItem in selectedItems
            set itemPaths to itemPaths & (POSIX path of (theItem as alias)) & linefeed
          end repeat
  
          return itemPaths
        on error errMsg
          return "Failed to get selected files: " & errMsg
        end try
      end tell
    `,
  },

• src/framework.ts:222-231 (registration)

  Registration of tools where each script is listed with name constructed as '{category.name}_{script.name}', creating 'finder_get_selected_files'.

  tools: this.categories.flatMap((category) =>
    category.scripts.map((script) => ({
      name: `${category.name}_${script.name}`, // Changed from dot to underscore
      description: `[${category.description}] ${script.description}`,
      inputSchema: script.schema || {
        type: "object",
        properties: {},
      },
    })),
  ),

• src/framework.ts:243-267 (handler)

  Core handler logic for parsing tool name 'finder_get_selected_files', extracting category 'finder' and script 'get_selected_files', and locating the script for execution.

  // Split on underscore instead of dot
  const [categoryName, ...scriptNameParts] =
    toolName.split("_");
  const scriptName = scriptNameParts.join("_"); // Rejoin in case script name has underscores
  
  const category = this.categories.find((c) => c.name === categoryName);
  if (!category) {
    this.log("warning", "Category not found", { categoryName });
    throw new McpError(
      ErrorCode.MethodNotFound,
      `Category not found: ${categoryName}`,
    );
  }
  
  const script = category.scripts.find((s) => s.name === scriptName);
  if (!script) {
    this.log("warning", "Script not found", { 
      categoryName, 
      scriptName 
    });
    throw new McpError(
      ErrorCode.MethodNotFound,
      `Script not found: ${scriptName}`,
    );
  }

• src/index.ts:27-27 (registration)

  Server registration of the finder category, which includes the get_selected_files script.

  server.addCategory(finderCategory);

• src/index.ts:4-4 (registration)

  Import of the finder category containing the tool implementation.

  import { finderCategory } from "./categories/finder.js";