kimhyungsik/ax_hub_mcp_tool
1
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: enforce underscore MCP tool names
Some checks failed
Deploy to OCIWP / deploy (push) Failing after 0s
Details

Browse Source
This commit is contained in:
jade
2026-08-11 10:18:36 +09:00
parent 40303ee9b8
commit 4275f76104
42 changed files with 380 additions and 52 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
dap-was-sms/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/converter/ClaimSearchConverter.java Normal file
View File

@@ -0,0 +1,14 @@
package io.shinhanlife.dap.mcc.biz.cmm.converter;
import io.shinhanlife.dap.mcc.biz.cmm.dto.ClaimSearchRequest;
import io.shinhanlife.dap.mcc.biz.cmm.dto.ClaimSearchResponse;
import io.shinhanlife.dap.mcc.infra.itrf.mci.ncla.io.CLCNNB00001_I;
import io.shinhanlife.dap.mcc.infra.itrf.mci.ncla.io.CLCNNB00001_O;
import org.mapstruct.Mapper;
@Mapper(componentModel = "spring")
public interface ClaimSearchConverter {
CLCNNB00001_I toLegacyRequest(ClaimSearchRequest request);
ClaimSearchRequest toRequest(CLCNNB00001_I mciRequest);
ClaimSearchResponse toResponse(CLCNNB00001_O mciRes);
}

16
dap-was-sms/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/ClaimSearchRequest.java Normal file
View File

@@ -0,0 +1,16 @@
package io.shinhanlife.dap.mcc.biz.cmm.dto;
import com.fasterxml.jackson.annotation.JsonInclude;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
@Data
@JsonInclude(JsonInclude.Include.NON_NULL)
public class ClaimSearchRequest {
@Schema(description = "보험금 청구번호", example = "CLM202608100001", requiredMode = Schema.RequiredMode.REQUIRED)
private String claimNo;
@Schema(description = "보험 계약번호", example = "10023456789")
private String contractNo;
}

22
dap-was-sms/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/dto/ClaimSearchResponse.java Normal file
View File

@@ -0,0 +1,22 @@
package io.shinhanlife.dap.mcc.biz.cmm.dto;
import com.fasterxml.jackson.annotation.JsonInclude;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
@Data
@JsonInclude(JsonInclude.Include.NON_NULL)
public class ClaimSearchResponse {
private String resultCode;
private String resultMessage;
@Schema(description = "청구 처리 상태 코드", example = "RECEIVED", requiredMode = Schema.RequiredMode.REQUIRED)
private String status;
@Schema(description = "청구 처리 상태명", example = "접수", requiredMode = Schema.RequiredMode.REQUIRED)
private String statusLabel;
@Schema(description = "승인 금액", example = "150000")
private Long approvedAmount;
}

29
dap-was-sms/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/ClaimSearchUseCase.java Normal file
View File

@@ -0,0 +1,29 @@
package io.shinhanlife.dap.mcc.biz.cmm.usecase;
import org.springaicommunity.mcp.annotation.McpTool;
import io.shinhanlife.dap.lib.annotation.ToolHint;
import io.shinhanlife.dap.mcc.biz.cmm.dto.ClaimSearchRequest;
import io.shinhanlife.dap.mcc.biz.cmm.dto.ClaimSearchResponse;
/**
* @package io.shinhanlife.dap.mcc.biz.cmm.usecase
* @className ClaimSearchUseCase
* @description AX HUB 시스템 처리 클래스
* @author jade
* @create 2026.08.10
* <pre>
* ---------- 개정이력 ----------
* 수정일 수정자 수정내용
* ---------- -------- ---------------------------
* 2026.08.10 jade 최초생성
*
* </pre>
*/
public interface ClaimSearchUseCase {
@McpTool(name = "sms_cmm_claim_search", title = "청구번호 또는 계약번호로 보험금 청구 상태를 조회한다.", description = "청구번호 또는 계약번호로 보험금 청구 상태를 조회한다.")
@ToolHint(register = false, categoryKey = "cmm", mappingId = "CLCNNB00001",
inputSchemaResource = "classpath:tool-schemas/cmm/claim-search-resource-input-schema.json",
outputSchemaResource = "classpath:tool-schemas/cmm/claim-search-resource-output-schema.json")
ClaimSearchResponse execute(ClaimSearchRequest req);
}

68
dap-was-sms/src/main/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/impl/ClaimSearchUseCaseImpl.java Normal file
View File

@@ -0,0 +1,68 @@
package io.shinhanlife.dap.mcc.biz.cmm.usecase.impl;
import io.shinhanlife.dap.mcc.biz.cmm.dto.ClaimSearchRequest;
import io.shinhanlife.dap.mcc.biz.cmm.dto.ClaimSearchResponse;
import io.shinhanlife.dap.mcc.biz.cmm.usecase.ClaimSearchUseCase;
import io.shinhanlife.glow.communication.dto.Transfer;
import org.springframework.stereotype.Service;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import io.shinhanlife.dap.mcc.biz.cmm.converter.ClaimSearchConverter;
import io.shinhanlife.dap.mcc.infra.itrf.mci.ncla.io.CLCNNB00001_I;
import io.shinhanlife.dap.mcc.infra.itrf.mci.ncla.io.CLCNNB00001_O;
import io.shinhanlife.dap.mcc.infra.itrf.mci.ncla.MciNclaClient;
/**
* @package io.shinhanlife.dap.mcc.biz.cmm.usecase.impl
* @className ClaimSearchUseCaseImpl
* @description AX HUB 시스템 처리 클래스
* @author jade
* @create 2026.08.10
* <pre>
* ---------- 개정이력 ----------
* 수정일 수정자 수정내용
* ---------- -------- ---------------------------
* 2026.08.10 jade 최초생성
*
* </pre>
*/
@Slf4j
@Service
@RequiredArgsConstructor
public class ClaimSearchUseCaseImpl implements ClaimSearchUseCase {
private final MciNclaClient mci;
private final ClaimSearchConverter converter;
@Override
public ClaimSearchResponse execute(ClaimSearchRequest req) {
log.info("[MCI Tool] {} 요청 수신.", "sms_cmm_claim_search");
try {
// MapStruct를 이용한 자동 매핑 (AI DTO -> MCI DTO)
CLCNNB00001_I mciReq = converter.toLegacyRequest(req);
Transfer<CLCNNB00001_O> resTransfer = mci.callTo(
"CLCNNB00001",
null,
mciReq,
CLCNNB00001_O.class
);
ClaimSearchResponse response = new ClaimSearchResponse();
if (resTransfer.getBody() != null) {
response = converter.toResponse(resTransfer.getBody());
}
response.setResultCode("SUCCESS");
response.setResultMessage(resTransfer.getBody() != null
? "MCI call completed."
: "MCI call completed without a response body.");
return response;
} catch (Exception e) {
log.error("[MCI Tool] 연동 중 오류 발생: {}", e.getMessage(), e);
ClaimSearchResponse response = new ClaimSearchResponse();
response.setResultCode("ERROR");
response.setResultMessage(e.getMessage() != null ? e.getMessage() : "Unknown error");
return response;
}
}
}

2
dap-was-sms/src/main/java/io/shinhanlife/dap/mcc/biz/sms/usecase/SmsToolUseCase.java
View File

@@ -5,7 +5,7 @@ import io.shinhanlife.dap.lib.annotation.ToolHint;
import io.shinhanlife.dap.mcc.biz.sms.dto.*;
public interface SmsToolUseCase {
@McpTool(name = "sms.sms.msg.send", title = "SMS 발송 툴", description = "SMS 발송 기능을 제공합니다.")
@McpTool(name = "sms_sms_msg_send", title = "SMS 발송 툴", description = "SMS 발송 기능을 제공합니다.")
@ToolHint(register = false, categoryKey = "sms", mappingId = "SMS_SEND")
Object sendSms(SmsSendRequest req);
}

30
dap-was-sms/src/main/java/io/shinhanlife/dap/mcc/infra/itrf/mci/ncla/MciNclaClient.java Normal file
View File

@@ -0,0 +1,30 @@
package io.shinhanlife.dap.mcc.infra.itrf.mci.ncla;
import org.springframework.stereotype.Component;
import lombok.RequiredArgsConstructor;
import io.shinhanlife.dap.lib.integration.mci.component.AxhubMciComponent;
import io.shinhanlife.glow.communication.dto.Transfer;
/**
* @package io.shinhanlife.dap.mcc.infra.itrf.mci.ncla
* @className MciNclaClient
* @description AX HUB 시스템 처리 클래스
* @author jade
* @create 2026.08.10
* <pre>
* ---------- 개정이력 ----------
* 수정일 수정자 수정내용
* ---------- -------- ---------------------------
* 2026.08.10 jade 최초생성
*
* </pre>
*/
@Component
@RequiredArgsConstructor
public class MciNclaClient {
private final AxhubMciComponent mci;
public <O> Transfer<O> callTo(String interfaceId, String dummy, Object mciReq, Class<O> resType) throws Exception {
return mci.callTo(interfaceId, dummy, mciReq, resType);
}
}

14
dap-was-sms/src/main/java/io/shinhanlife/dap/mcc/infra/itrf/mci/ncla/io/CLCNNB00001_I.java Normal file
View File

@@ -0,0 +1,14 @@
package io.shinhanlife.dap.mcc.infra.itrf.mci.ncla.io;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
@Data
public class CLCNNB00001_I {
@Schema(description = "보험금 청구번호", example = "CLM202608100001", requiredMode = Schema.RequiredMode.REQUIRED)
private String claimNo;
@Schema(description = "보험 계약번호", example = "10023456789")
private String contractNo;
}

17
dap-was-sms/src/main/java/io/shinhanlife/dap/mcc/infra/itrf/mci/ncla/io/CLCNNB00001_O.java Normal file
View File

@@ -0,0 +1,17 @@
package io.shinhanlife.dap.mcc.infra.itrf.mci.ncla.io;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
@Data
public class CLCNNB00001_O {
@Schema(description = "청구 처리 상태 코드", example = "RECEIVED", requiredMode = Schema.RequiredMode.REQUIRED)
private String status;
@Schema(description = "청구 처리 상태명", example = "접수", requiredMode = Schema.RequiredMode.REQUIRED)
private String statusLabel;
@Schema(description = "승인 금액", example = "150000")
private Long approvedAmount;
}

5
dap-was-sms/src/main/resources/mock-responses/sms_cmm_claim_search.json Normal file
View File

@@ -0,0 +1,5 @@
{
"status" : "RECEIVED",
"statusLabel" : "접수",
"approvedAmount" : 150000
}

11
dap-was-sms/src/main/resources/tool-schemas/cmm/claim-search-resource-input-schema.json Normal file
View File

@@ -0,0 +1,11 @@
{
"type": "object",
"additionalProperties": false,
"properties": {
"TODO_FIELD": {
"type": "string",
"description": "TODO: 파라미터 설명을 입력하세요."
}
},
"required": []
}

16
dap-was-sms/src/main/resources/tool-schemas/cmm/claim-search-resource-output-schema.json Normal file
View File

@@ -0,0 +1,16 @@
{
"type": "object",
"additionalProperties": false,
"properties": {
"status": {
"type": "string",
"description": "처리 결과 상태 (SUCCESS / FAILURE)",
"enum": ["SUCCESS", "FAILURE"]
},
"message": {
"type": "string",
"description": "처리 결과 메시지"
}
},
"required": ["status"]
}

16
dap-was-sms/src/test/java/io/shinhanlife/dap/mcc/biz/cmm/usecase/ClaimSearchUseCaseTest.java Normal file
View File

@@ -0,0 +1,16 @@
package io.shinhanlife.dap.mcc.biz.cmm.usecase;
import static org.junit.jupiter.api.Assertions.assertNotNull;
import io.shinhanlife.dap.mcc.biz.cmm.dto.ClaimSearchRequest;
import io.shinhanlife.dap.mcc.biz.cmm.dto.ClaimSearchResponse;
import org.junit.jupiter.api.Test;
class ClaimSearchUseCaseTest {
@Test
void createsToolRequestAndResponseDtos() {
assertNotNull(new ClaimSearchRequest());
assertNotNull(new ClaimSearchResponse());
}
}