FitSlot MCP Server

Instructions

Implementation Reference

• src/tools/pdf.tools.ts:88-159 (handler)

  MCP tool handler for 'analyze_bioimpedance_pdf_base64'. Defines input schema with Zod, executes PDF analysis from base64 data using PDFAnalysisService, and returns structured JSON response with health metrics, analysis, and recommendations.

  analyze_bioimpedance_pdf_base64: {
    description: 'Analyze a bioimpedance PDF document from base64-encoded data',
    parameters: z.object({
      base64Data: z.string().describe('Base64-encoded PDF data'),
      patientId: z.string().optional().describe('Optional patient ID for reference')
    }),
    execute: async (args: { base64Data: string; patientId?: string }) => {
      try {
        logger.info('Analyzing bioimpedance PDF from base64', {
          patientId: args.patientId,
          dataLength: args.base64Data.length
        });
  
        validateNotEmpty(args.base64Data, 'Base64 data');
  
        const analysis = await pdfService.analyzeBioimpedancePDFFromBase64(args.base64Data);
  
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify(
                {
                  success: true,
                  patientId: args.patientId,
                  analysis: {
                    patientInfo: {
                      name: analysis.patientName,
                      date: analysis.date
                    },
                    measurements: {
                      weight: analysis.weight ? `${analysis.weight} kg` : 'N/A',
                      height: analysis.height ? `${analysis.height} cm` : 'N/A',
                      bmi: analysis.bmi || 'N/A',
                      bodyFatPercentage: analysis.bodyFatPercentage ? `${analysis.bodyFatPercentage}%` : 'N/A',
                      muscleMassPercentage: analysis.muscleMassPercentage ? `${analysis.muscleMassPercentage}%` : 'N/A',
                      boneMass: analysis.boneMass ? `${analysis.boneMass} kg` : 'N/A',
                      bodyWaterPercentage: analysis.bodyWaterPercentage ? `${analysis.bodyWaterPercentage}%` : 'N/A',
                      visceralFat: analysis.visceralFat || 'N/A',
                      bmr: analysis.bmr ? `${analysis.bmr} kcal` : 'N/A'
                    },
                    analysis: analysis.analysis,
                    recommendations: analysis.recommendations
                  }
                },
                null,
                2
              )
            }
          ]
        };
      } catch (error) {
        logger.error('Failed to analyze bioimpedance PDF from base64', error);
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify(
                {
                  success: false,
                  error: error instanceof Error ? error.message : 'Unknown error'
                },
                null,
                2
              )
            }
          ],
          isError: true
        };
      }
    }
  }

• src/index.ts:60-68 (registration)

  Registers the PDF tools (including analyze_bioimpedance_pdf_base64) by calling createPDFTools and merging into the allTools object used by MCP server handlers.

  const ticketTools = createTicketTools(apiService);
  const chatbotTools = createChatbotTools(chatbotService);
  const pdfTools = createPDFTools(pdfService);
  
  const allTools = {
    ...ticketTools,
    ...chatbotTools,
    ...pdfTools
  };

• src/services/pdf-analysis.service.ts:260-295 (helper)

  Core service method that implements the bioimpedance PDF analysis from base64: decodes data, parses PDF text, extracts measurements using regex patterns, generates analysis/recommendations, optionally enhances with AI.

  async analyzeBioimpedancePDFFromBase64(base64Data: string): Promise<BioimpedanceData> {
    try {
      logger.info('Starting PDF analysis from base64');
  
      // Decode base64 to buffer
      const buffer = Buffer.from(base64Data, 'base64');
      
      // Create parser and extract text
      const pdfParser = new PDFParse({ data: buffer });
      const textResult = await pdfParser.getText();
  
      logger.debug('PDF parsed successfully', {
        pages: textResult.pages.length,
        textLength: textResult.text.length
      });
  
      // Extract bioimpedance data from text
      const extractedData = this.extractBioimpedanceData(textResult.text);
  
      // Generate analysis and recommendations
      const insights = await this.enhanceWithAI(extractedData);
      const { analysis, recommendations } = insights;
  
      const result: BioimpedanceData = {
        ...extractedData,
        analysis,
        recommendations
      };
  
      logger.info('PDF analysis completed successfully');
      return result;
    } catch (error) {
      logger.error('Failed to analyze PDF from base64', error);
      throw new Error(`PDF analysis failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
    }
  }

• src/services/pdf-analysis.service.ts:58-133 (helper)

  Helper method that uses regex patterns to extract key bioimpedance measurements (patient info, weight, height, BMI, body fat %, muscle %, etc.) from parsed PDF text.

  private extractBioimpedanceData(text: string): Omit<BioimpedanceData, 'analysis' | 'recommendations'> {
    const data: Omit<BioimpedanceData, 'analysis' | 'recommendations'> = {};
  
    // Extract patient name
    const nameMatch = text.match(/(?:paciente|patient|nome|name)[:\s]+([^\n]+)/i);
    if (nameMatch) {
      data.patientName = nameMatch[1].trim();
    }
  
    // Extract date
    const dateMatch = text.match(/(?:data|date)[:\s]+(\d{1,2}[\/\-]\d{1,2}[\/\-]\d{2,4})/i);
    if (dateMatch) {
      data.date = dateMatch[1];
    }
  
    // Extract weight (kg)
    const weightMatch = text.match(/(?:peso|weight)[:\s]+(\d+(?:\.\d+)?)\s*(?:kg)?/i);
    if (weightMatch) {
      data.weight = parseFloat(weightMatch[1]);
    }
  
    // Extract height (cm)
    const heightMatch = text.match(/(?:altura|height)[:\s]+(\d+(?:\.\d+)?)\s*(?:cm)?/i);
    if (heightMatch) {
      data.height = parseFloat(heightMatch[1]);
    }
  
    // Extract body fat percentage
    const bodyFatMatch = text.match(/(?:gordura corporal|body fat|%\s*gordura)[:\s]+(\d+(?:\.\d+)?)\s*%?/i);
    if (bodyFatMatch) {
      data.bodyFatPercentage = parseFloat(bodyFatMatch[1]);
    }
  
    // Extract muscle mass percentage
    const muscleMassMatch = text.match(/(?:massa muscular|muscle mass|%\s*m[uú]sculo)[:\s]+(\d+(?:\.\d+)?)\s*%?/i);
    if (muscleMassMatch) {
      data.muscleMassPercentage = parseFloat(muscleMassMatch[1]);
    }
  
    // Extract bone mass (kg)
    const boneMassMatch = text.match(/(?:massa [óo]ssea|bone mass)[:\s]+(\d+(?:\.\d+)?)\s*(?:kg)?/i);
    if (boneMassMatch) {
      data.boneMass = parseFloat(boneMassMatch[1]);
    }
  
    // Extract body water percentage
    const bodyWaterMatch = text.match(/(?:[áa]gua corporal|body water|%\s*[áa]gua)[:\s]+(\d+(?:\.\d+)?)\s*%?/i);
    if (bodyWaterMatch) {
      data.bodyWaterPercentage = parseFloat(bodyWaterMatch[1]);
    }
  
    // Extract visceral fat
    const visceralFatMatch = text.match(/(?:gordura visceral|visceral fat)[:\s]+(\d+(?:\.\d+)?)/i);
    if (visceralFatMatch) {
      data.visceralFat = parseFloat(visceralFatMatch[1]);
    }
  
    // Extract BMR (Basal Metabolic Rate)
    const bmrMatch = text.match(/(?:taxa metab[óo]lica basal|bmr|tmb)[:\s]+(\d+(?:\.\d+)?)\s*(?:kcal)?/i);
    if (bmrMatch) {
      data.bmr = parseFloat(bmrMatch[1]);
    }
  
    // Calculate or extract BMI
    const bmiMatch = text.match(/(?:imc|bmi)[:\s]+(\d+(?:\.\d+)?)/i);
    if (bmiMatch) {
      data.bmi = parseFloat(bmiMatch[1]);
    } else if (data.weight && data.height) {
      // Calculate BMI if not found: BMI = weight(kg) / (height(m))^2
      const heightInMeters = data.height / 100;
      data.bmi = parseFloat((data.weight / (heightInMeters * heightInMeters)).toFixed(2));
    }
  
    logger.debug('Extracted bioimpedance data', data);
    return data;
  }

• src/types/index.ts:63-72 (schema)

  TypeScript interface defining the structure of bioimpedance analysis data returned by the tool.

  export interface BioimpedanceData {
    patientName?: string;
    date?: string;
    weight?: number;
    height?: number;
    bodyFatPercentage?: number;
    muscleMassPercentage?: number;
    boneMass?: number;
    bodyWaterPercentage?: number;
    visceralFat?: number;