mac-use-mcp

Instructions

Implementation Reference

• src/tools/mouse.ts:225-243 (handler)

  Handler function for move_mouse tool.

  /** Handle move_mouse tool call. */
  async function handleMoveMouse(
    args: Record<string, unknown>,
  ): Promise<CallToolResult> {
    const parsed = MoveMouseInputSchema.parse(args);
  
    const result = await runInputHelper("move", { x: parsed.x, y: parsed.y });
  
    const response: Record<string, unknown> = {
      moved_to: { x: parsed.x, y: parsed.y },
    };
    if (typeof result.warning === "string") {
      response.warning = result.warning;
    }
  
    return {
      content: [{ type: "text" as const, text: JSON.stringify(response) }],
    };
  }

• src/tools/mouse.ts:66-79 (schema)

  Input schema for move_mouse tool.

  const MoveMouseInputSchema = z.object({
    x: z
      .number()
      .int()
      .describe(
        "X coordinate in screen pixels (may be negative for secondary displays)",
      ),
    y: z
      .number()
      .int()
      .describe(
        "Y coordinate in screen pixels (may be negative for secondary displays)",
      ),
  });

• src/tools/mouse.ts:154-162 (registration)

  Registration of move_mouse tool.

  {
    name: "move_mouse",
    description: `Move the mouse cursor to the specified screen coordinates without clicking. ${SILENT_HINT}`,
    inputSchema: zodToToolInputSchema(MoveMouseInputSchema),
    annotations: {
      readOnlyHint: false,
      destructiveHint: false,
    },
  },