get_facility_group_list

Instructions

Implementation Reference

• src/index.ts:338-388 (handler)

  MCP tool handler case for 'get_facility_group_list': extracts parameters from tool call, invokes the YouthApiClient method, formats the paginated results into a human-readable text response with details like facility name, institution, type, address, and phone.

  case "get_facility_group_list": {
    const params = {
      pageNo: (args?.pageNo as number) || 1,
      numOfRows: (args?.numOfRows as number) || 10,
      sido: args?.sido as string | undefined,
      stName: args?.stName as string | undefined,
      gName: args?.gName as string | undefined,
    };
  
    const result = await youthApiClient.getFacilityGroupList(params);
  
    let resultText = `🏢 청소년 시설 그룹 목록 (전체 ${result.totalCount}개)\n\n`;
  
    if (Array.isArray(result.items)) {
      result.items.forEach((item: any, index: number) => {
        const itemNum = (params.pageNo - 1) * params.numOfRows + index + 1;
        resultText += `${itemNum}. ${item.faciNm || "시설명 없음"}\n`;
        if (item.instlNm)
          resultText += `   기관명: ${item.instlNm}\n`;
        if (item.gNm)
          resultText += `   유형: ${item.gNm}\n`;
        if (item.rdnmadr)
          resultText += `   주소: ${item.rdnmadr}\n`;
        if (item.phoneNumber)
          resultText += `   전화: ${item.phoneNumber}\n`;
        resultText += "\n";
      });
    } else if (result.items) {
      resultText += `1. ${result.items.faciNm || "시설명 없음"}\n`;
      if (result.items.instlNm)
        resultText += `   기관명: ${result.items.instlNm}\n`;
      if (result.items.gNm)
        resultText += `   유형: ${result.items.gNm}\n`;
      resultText += "\n";
    } else {
      resultText += "검색된 시설이 없습니다.\n\n";
    }
  
    resultText += `페이지: ${params.pageNo}/${Math.ceil(
      result.totalCount / params.numOfRows
    )}`;
  
    return {
      content: [
        {
          type: "text",
          text: resultText,
        },
      ],
    };
  }

• src/youthApiClient.ts:182-232 (handler)

  Core implementation of getFacilityGroupList in YouthApiClient: makes HTTP GET to '/getJltlsGrpList' endpoint with pagination and filter params, parses XML response using xml2js, validates resultCode, extracts totalCount and items, handles errors.

  async getFacilityGroupList(params: {
    pageNo?: number;
    numOfRows?: number;
    sido?: string; // 시도
    stName?: string; // 기관명
    gName?: string; // 기관유형명
  }): Promise<any> {
    try {
      const response = await this.client.get("/getJltlsGrpList", {
        params: {
          serviceKey: this.serviceKey,
          pageNo: params.pageNo || 1,
          numOfRows: params.numOfRows || 10,
          sido: params.sido,
          stName: params.stName,
          gName: params.gName,
        },
      });
  
      const parsedData = await this.parseXmlResponse(response.data);
  
      if (parsedData.response) {
        const header = parsedData.response.header;
        const body = parsedData.response.body;
  
        if (header?.resultCode !== "00") {
          throw new Error(
            `API 오류: ${header?.resultMsg || "알 수 없는 오류"}`
          );
        }
  
        return {
          totalCount: parseInt(body?.totalCount || "0"),
          items: body?.items?.item || [],
          pageNo: params.pageNo || 1,
          numOfRows: params.numOfRows || 10,
        };
      }
  
      throw new Error("예상치 못한 응답 형식");
    } catch (error) {
      if (axios.isAxiosError(error)) {
        throw new Error(
          `API 호출 실패: ${error.message}${
            error.response?.data ? ` - ${error.response.data}` : ""
          }`
        );
      }
      throw error;
    }
  }

• src/index.ts:134-162 (registration)

  MCP tool registration in ListToolsRequestSchema handler: defines name 'get_facility_group_list', description, and inputSchema for parameters like pageNo, numOfRows, sido, stName, gName.

  {
    name: "get_facility_group_list",
    description: "청소년 시설 그룹 목록을 조회합니다. 시도, 기관명, 기관유형으로 필터링 가능합니다",
    inputSchema: {
      type: "object",
      properties: {
        pageNo: {
          type: "number",
          description: "페이지 번호 (기본값: 1)",
        },
        numOfRows: {
          type: "number",
          description: "한 페이지 결과 수 (기본값: 10)",
        },
        sido: {
          type: "string",
          description: "시도명 (선택사항)",
        },
        stName: {
          type: "string",
          description: "기관명 (선택사항)",
        },
        gName: {
          type: "string",
          description: "기관유형명 (선택사항)",
        },
      },
    },
  },