automator-mcp

Instructions

Implementation Reference

• src/index.js:209-226 (handler)

  Executes the provided AppleScript code using the `osascript` command via Node.js `execSync`, with single quote escaping for safety. Returns the result as MCP content or throws an error.

  async runAppleScript(script) {
    try {
      const result = execSync(`osascript -e '${script.replace(/'/g, "'\"'\"'")}'`, {
        encoding: 'utf8',
      });
      
      return {
        content: [
          {
            type: 'text',
            text: result.trim() || 'Script executed successfully',
          },
        ],
      };
    } catch (error) {
      throw new Error(`AppleScript error: ${error.message}`);
    }
  }

• src/index.js:37-50 (registration)

  Registers the 'run_applescript' tool in the ListTools response, including name, description, and input schema.

  {
    name: 'run_applescript',
    description: 'Execute AppleScript code on macOS',
    inputSchema: {
      type: 'object',
      properties: {
        script: {
          type: 'string',
          description: 'AppleScript code to execute',
        },
      },
      required: ['script'],
    },
  },

• src/index.js:40-49 (schema)

  Defines the input schema for the 'run_applescript' tool, requiring a 'script' property of type string.

  inputSchema: {
    type: 'object',
    properties: {
      script: {
        type: 'string',
        description: 'AppleScript code to execute',
      },
    },
    required: ['script'],
  },

• src/index.js:175-176 (handler)

  Dispatches calls to the 'run_applescript' tool by invoking the runAppleScript method in the CallToolRequest handler.

  case 'run_applescript':
    return await this.runAppleScript(args.script);