WeChat Mini Program Dev MCP

Instructions

Implementation Reference

• src/tools/element.ts:210-234 (handler)

  Full tool object returned by createSetElementDataTool, including the execute handler that resolves the element using resolveElement, calls element.setData with the provided data, computes updated data keys, and returns a textual confirmation.

  return {
    name: "element_setData",
    description: "设置组件实例渲染数据，仅自定义组件可以使用。需要 automator 0.6.0 和基础库 2.9.0 及以上版本。使用 ID 选择器(如 #my-component)定位自定义组件。",
    parameters: setElementDataParameters,
    execute: async (rawArgs, context: ToolContext) => {
      const args = setElementDataParameters.parse(rawArgs ?? {});
      return manager.withPage(
        context.log,
        { overrides: args.connection },
        async (page) => {
          const element = await resolveElement(
            page,
            args.selector,
            args.innerSelector
          );
  
          await element.setData(args.data);
          const dataKeys = Object.keys(args.data ?? {});
          return toTextResult(
            `已更新组件数据键: ${dataKeys.length ? dataKeys.join(", ") : "(无)"}。`
          );
        }
      );
    },
  };

• src/tools/element.ts:41-45 (schema)

  Zod schema for tool parameters: connection container, selector (required string), optional innerSelector (string), and data (record of unknown).

  const setElementDataParameters = connectionContainerSchema.extend({
    selector: z.string().trim().min(1),
    innerSelector: z.string().trim().min(1).optional(),
    data: z.record(z.unknown()),
  });

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

  The createElementTools function registers the element_setData tool by including createSetElementDataTool(manager) in its returned array of tools.

  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)

  Top-level createTools function registers all tools, including element tools (thus element_setData) by spreading createElementTools(manager).

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