MCP Server for Google Cloud Healthcare API

Instructions

Implementation Reference

• src/server/connectors/fhir/FhirClient.ts:166-175 (handler)

  The core handler function that implements the get_patient_procedures tool by searching FHIR Procedure resources filtered by patient ID, status, and date range.

  async getPatientProcedures(args: any) {
    const params = new URLSearchParams();
    params.append('patient', `${args.patientId}`);
    if (args.status) params.append('status', args.status);
    if (args.dateFrom) params.append('date', `ge${args.dateFrom}`);
    if (args.dateTo) params.append('date', `le${args.dateTo}`);
  
    const response = await this.client.get(`/Procedure?${params}`);
    return this.formatResponse(`fhir://Patient/${args.patientId}/procedures`, response.data);
  }

• src/server/constants/tools.ts:108-123 (schema)

  Input schema definition and tool metadata used for validation and listing the tool.

  {
    name: "get_patient_procedures",
    description: "Get procedures performed on a patient",
    inputSchema: {
      type: "object",
      properties: {
        patientId: { type: "string" },
        status: {
          type: "string",
          enum: ["preparation", "in-progress", "completed", "entered-in-error"]
        },
        dateFrom: { type: "string", description: "YYYY-MM-DD" },
        dateTo: { type: "string", description: "YYYY-MM-DD" }
      },
      required: ["patientId"]
    }

• src/server/handlers/ToolHandler.ts:78-79 (registration)

  Switch case in the central tool dispatcher that routes calls to the get_patient_procedures handler in FhirClient.

  case "get_patient_procedures":
    return await this.fhirClient.getPatientProcedures(request.params.arguments);