MCP Server for Google Cloud Healthcare API

Instructions

Implementation Reference

• src/server/connectors/fhir/FhirClient.ts:186-196 (handler)

  Core implementation of get_patient_careplans tool. Queries FHIR CarePlan resource filtered by patient ID, status, category, and date range. Formats response using formatResponse helper.

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

• src/server/constants/tools.ts:126-142 (schema)

  Tool definition including name, description, and input schema validation for get_patient_careplans.

    name: "get_patient_careplans",
    description: "Get care plans for a patient",
    inputSchema: {
      type: "object",
      properties: {
        patientId: { type: "string" },
        status: {
          type: "string",
          enum: ["draft", "active", "suspended", "completed", "cancelled"]
        },
        category: { type: "string" },
        dateFrom: { type: "string", description: "YYYY-MM-DD" },
        dateTo: { type: "string", description: "YYYY-MM-DD" }
      },
      required: ["patientId"]
    }
  },

• src/server/handlers/ToolHandler.ts:82-83 (registration)

  ToolHandler switch case that registers and dispatches the get_patient_careplans tool call to the FhirClient implementation.

  case "get_patient_careplans":
    return await this.fhirClient.getPatientCarePlans(request.params.arguments);