wa_business_list

Instructions

Implementation Reference

• src/tools.ts:160-215 (handler)

  Generic handler function that implements the core logic for the 'wa_business_list' tool by proxying requests to the YCloud WhatsApp Business Account API endpoint.

  async (args: Record<string, any>) => {
    try {
      // 解析URL中的路径参数
      let url = `${apiBaseUrl}${path}`;
      Object.keys(args).forEach(key => {
        if (path.includes(`{${key}}`)) {
          url = url.replace(`{${key}}`, encodeURIComponent(String(args[key])));
          delete args[key];
        }
      });
      
      // 提取请求体和查询参数
      const { body, ...queryParams } = args as Record<string, any>;
      
      // 设置请求选项
      const requestOptions: any = {
        url,
        method: method.toUpperCase(),
        headers: { 
          'Content-Type': 'application/json',
          ...headers
        },
        params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
        data: body,
      };
      
      // 发送请求
      const response = await axios(requestOptions);
      return {
        content: [{ type: 'text' as const, text: JSON.stringify(response.data, null, 2) }]
      };
    } catch (error: unknown) {
      if (axios.isAxiosError(error) && error.response) {
        return {
          content: [{
            type: 'text' as const,
            text: JSON.stringify({
              error: true,
              status: error.response.status,
              message: error.response.data?.message || error.message,
              data: error.response.data
            }, null, 2)
          }]
        };
      }
      return {
        content: [{
          type: 'text' as const,
          text: JSON.stringify({
            error: true,
            message: error instanceof Error ? error.message : String(error)
          }, null, 2)
        }]
      };
    }
  }

• src/tools.ts:9-50 (schema)

  Schema extraction function that generates Zod-based input validation schema for the 'wa_business_list' tool parameters from the OpenAPI specification.

  function extractParamsSchema(operation: any): any {
    const properties: Record<string, any> = {};
    const required: string[] = [];
  
    // 处理路径参数
    if (operation.parameters) {
      operation.parameters.forEach((param: any) => {
        if (param.in === 'path' || param.in === 'query') {
          let schema;
          switch (param.schema?.type) {
            case 'string':
              schema = z.string();
              break;
            case 'integer':
              schema = z.number().int();
              break;
            case 'number':
              schema = z.number();
              break;
            case 'boolean':
              schema = z.boolean();
              break;
            default:
              schema = z.any();
          }
          
          properties[param.name] = schema;
          if (param.required) {
            required.push(param.name);
          }
        }
      });
    }
  
    // 处理请求体
    if (operation.requestBody) {
      properties['body'] = z.any();
      required.push('body');
    }
  
    return properties;
  }

• src/tools.ts:101-104 (registration)

  Specific registration logic that maps OpenAPI operations containing 'whatsapp_business_account' to the 'wa_business_list' tool name (when action is 'list').

  } else if (operationId.includes('whatsapp_business_account')) {
    // 从operationId中提取动作部分（list, retrieve等）
    const action = operationId.split('-')[1] || '';
    operationId = `wa_business_${action}`;

• src/tools.ts:156-219 (registration)

  Tool registration call where 'wa_business_list' is registered with MCP server using the dynamically generated name, description, and schema.

    server.tool(
      toolName,
      description,
      paramsSchema,
      async (args: Record<string, any>) => {
        try {
          // 解析URL中的路径参数
          let url = `${apiBaseUrl}${path}`;
          Object.keys(args).forEach(key => {
            if (path.includes(`{${key}}`)) {
              url = url.replace(`{${key}}`, encodeURIComponent(String(args[key])));
              delete args[key];
            }
          });
          
          // 提取请求体和查询参数
          const { body, ...queryParams } = args as Record<string, any>;
          
          // 设置请求选项
          const requestOptions: any = {
            url,
            method: method.toUpperCase(),
            headers: { 
              'Content-Type': 'application/json',
              ...headers
            },
            params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
            data: body,
          };
          
          // 发送请求
          const response = await axios(requestOptions);
          return {
            content: [{ type: 'text' as const, text: JSON.stringify(response.data, null, 2) }]
          };
        } catch (error: unknown) {
          if (axios.isAxiosError(error) && error.response) {
            return {
              content: [{
                type: 'text' as const,
                text: JSON.stringify({
                  error: true,
                  status: error.response.status,
                  message: error.response.data?.message || error.message,
                  data: error.response.data
                }, null, 2)
              }]
            };
          }
          return {
            content: [{
              type: 'text' as const,
              text: JSON.stringify({
                error: true,
                message: error instanceof Error ? error.message : String(error)
              }, null, 2)
            }]
          };
        }
      }
    );
    registeredTools.add(toolName);
    registeredToolsCount++;
  }

• src/index.ts:42-43 (registration)

  Invocation of the tool registration function that includes 'wa_business_list' among the WhatsApp tools.

  const openApiSpec = await loadOpenApiSpec(openApiSpecPath);
  await registerYCloudTools(server, openApiSpec, apiBaseUrl, headers);