applescript-mcp

Instructions

Implementation Reference

• src/categories/system.ts:103-113 (handler)

  AppleScript implementation that retrieves battery status using the 'pmset -g batt' shell command.

    name: "get_battery_status",
    description: "Get battery level and charging status",
    script: `
          try
            set powerSource to do shell script "pmset -g batt"
            return powerSource
          on error errMsg
            return "Failed to get battery status: " & errMsg
          end try
        `,
  },

• src/framework.ts:221-232 (registration)

  Dynamically generates the tool list for MCP, constructing tool names as '{category.name}_{script.name}' (e.g., 'system_get_battery_status') from registered categories and scripts.

  this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
    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/index.ts:25-25 (registration)

  Registers the 'system' category (containing 'get_battery_status') with the MCP server.

  server.addCategory(systemCategory);

• src/framework.ts:280-294 (handler)

  Generic tool execution handler that resolves the tool name to category/script, generates/runs the AppleScript, and returns the result.

  const result = await this.executeScript(scriptContent);
  
  this.log("info", "Tool execution completed successfully", { 
    tool: toolName,
    resultLength: result.length
  });
  
  return {
    content: [
      {
        type: "text",
        text: result,
      },
    ],
  };