WeChat Mini Program Dev MCP

Instructions

Implementation Reference

• src/tools/element.ts:86-114 (handler)

  Full tool definition including the execute handler for the 'element_tap' tool. It parses arguments, resolves the target element using selector and optional innerSelector, performs a tap action, optionally waits, and returns a confirmation message.

  function createTapElementTool(manager: WeappAutomatorManager): AnyTool {
    return {
      name: "element_tap",
      description: "通过 CSS 选择器模拟点击 WXML 元素。如需点击自定义组件内部的元素，请使用 innerSelector 参数：selector 设为组件 ID 选择器(如 #my-component)，innerSelector 设为组件内部元素的选择器。",
      parameters: tapElementParameters,
      execute: async (rawArgs, context: ToolContext) => {
        const args = tapElementParameters.parse(rawArgs ?? {});
        const waitMs = args.waitMs;
        return manager.withPage(
          context.log,
          { overrides: args.connection },
          async (page) => {
            const element = await resolveElement(
              page,
              args.selector,
              args.innerSelector
            );
  
            await element.tap();
            await waitOnPage(page, waitMs);
  
            return toTextResult(
              `已点击元素 "${args.selector}"${args.innerSelector ? ` -> "${args.innerSelector}"` : ""}${waitMs ? ` 并等待 ${waitMs}ms` : ""}。`
            );
          }
        );
      },
    };
  }

• src/tools/element.ts:16-20 (schema)

  Zod schema defining the input parameters for the 'element_tap' tool: selector (required), innerSelector (optional), and waitMs (optional).

  const tapElementParameters = connectionContainerSchema.extend({
    selector: z.string().trim().min(1),
    innerSelector: z.string().trim().min(1).optional(),
    waitMs: z.coerce.number().int().nonnegative().optional(),
  });

• src/tools/element.ts:70-84 (registration)

  The 'element_tap' tool is registered as the first tool in the array returned by createElementTools.

  export function createElementTools(
    manager: WeappAutomatorManager
  ): AnyTool[] {
    return [
      createTapElementTool(manager),
      createInputTextTool(manager),
      createCallElementMethodTool(manager),
      createGetElementDataTool(manager),
      createSetElementDataTool(manager),
      createGetInnerElementTool(manager),
      createGetInnerElementsTool(manager),
      createGetElementSizeTool(manager),
      createGetElementWxmlTool(manager),
    ];
  }

• src/tools.ts:7-13 (registration)

  createTools incorporates the element tools (including element_tap) into the full tools array.

  export function createTools(manager: WeappAutomatorManager): AnyTool[] {
    return [
      ...createApplicationTools(manager),
      ...createPageTools(manager),
      ...createElementTools(manager),
    ];
  }

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

  Final registration of all tools, including element_tap, to the FastMCP server.

  server.addTools(createTools(manager));