WeChat Mini Program Dev MCP

Instructions

Implementation Reference

• src/tools/element.ts:116-141 (handler)

  The createInputTextTool function returns the tool definition including the execute handler which parses args, resolves the element using resolveElement, calls element.input(value), and returns a success message.

  function createInputTextTool(manager: WeappAutomatorManager): AnyTool {
    return {
      name: "element_input",
      description: "向指定元素输入文本。如需向自定义组件内部的元素输入，请使用 innerSelector 参数：selector 设为组件 ID 选择器(如 #my-component)，innerSelector 设为组件内部元素的选择器。",
      parameters: inputTextParameters,
      execute: async (rawArgs, context: ToolContext) => {
        const args = inputTextParameters.parse(rawArgs ?? {});
        return manager.withPage(
          context.log,
          { overrides: args.connection },
          async (page) => {
            const element = await resolveElement(
              page,
              args.selector,
              args.innerSelector
            );
  
            await element.input(args.value);
            return toTextResult(
              `已向元素 "${args.selector}"${args.innerSelector ? ` -> "${args.innerSelector}"` : ""} 输入值 "${args.value}"。`
            );
          }
        );
      },
    };
  }

• src/tools/element.ts:22-26 (schema)

  Zod schema defining the input parameters for the element_input tool: selector (required string), innerSelector (optional string), value (string or number).

  const inputTextParameters = connectionContainerSchema.extend({
    selector: z.string().trim().min(1),
    innerSelector: z.string().trim().min(1).optional(),
    value: z.union([z.string(), z.coerce.number()]),
  });

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

  The element_input tool (via createInputTextTool) is registered in the array returned by createElementTools.

  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 includes the tools from createElementTools, which contains element_input.

  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_input, to the FastMCP server.

  server.addTools(createTools(manager));