MCP Tauri Automation

Instructions

Implementation Reference

• src/tools/interact.ts:11-30 (handler)

  Primary handler function for the 'click_element' tool. It receives the driver instance and parameters, delegates to the driver's clickElement method, and formats the response as ToolResponse with success/error handling.

  export async function clickElement(
    driver: TauriDriver,
    params: ElementSelector
  ): Promise<ToolResponse<{ message: string }>> {
    try {
      await driver.clickElement(params.selector);
  
      return {
        success: true,
        data: {
          message: `Clicked element: ${params.selector}`,
        },
      };
    } catch (error) {
      return {
        success: false,
        error: error instanceof Error ? error.message : String(error),
      };
    }
  }

• src/tauri-driver.ts:120-129 (handler)

  Core implementation of element clicking using WebDriverIO. Finds the element by CSS selector, checks existence, and performs the click action.

  async clickElement(selector: string): Promise<void> {
    this.ensureAppRunning();
  
    const element = await this.appState.browser!.$(selector);
    if (!(await element.isExisting())) {
      throw new Error(`Element not found: ${selector}`);
    }
  
    await element.click();
  }

• src/index.ts:102-115 (registration)

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

  {
    name: 'click_element',
    description: 'Click a UI element identified by a CSS selector',
    inputSchema: {
      type: 'object',
      properties: {
        selector: {
          type: 'string',
          description: 'CSS selector to identify the element to click (e.g., "#button-id", ".button-class", "button[name=submit]")',
        },
      },
      required: ['selector'],
    },
  },

• src/index.ts:262-272 (handler)

  MCP CallToolRequest dispatcher case for 'click_element', invokes the clickElement handler and returns the result as MCP content.

  case 'click_element': {
    const result = await clickElement(driver, args as any);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }

• src/index.ts:105-114 (schema)

  Input schema definition for the 'click_element' tool, specifying the required 'selector' parameter.

  inputSchema: {
    type: 'object',
    properties: {
      selector: {
        type: 'string',
        description: 'CSS selector to identify the element to click (e.g., "#button-id", ".button-class", "button[name=submit]")',
      },
    },
    required: ['selector'],
  },