McpFunction에 MCP 표준 힌트 4개 추가

dap-gateway/src/main/java/io/shinhanlife/dap/biz/mcp/gateway/dto/ToolMetadata.java

@@ -71,6 +71,18 @@ public class ToolMetadata {
     @Builder.Default
     private Boolean requiresApproval = false;
 
+    @Builder.Default
+    private Boolean readOnlyHint = false;
+
+    @Builder.Default
+    private Boolean destructiveHint = false;
+
+    @Builder.Default
+    private Boolean idempotentHint = false;
+
+    @Builder.Default
+    private Boolean openWorldHint = false;
+
 
 
     // 3. 연동 아키텍처 구분 (DIRECT / MCI_EAI)
@@ -113,4 +125,4 @@ public class ToolMetadata {
         if (parametersSchema == null || !parametersSchema.containsKey("required")) return Set.of();
         return new HashSet<>((List<String>) parametersSchema.get("required"));
     }
-}
+}

dap-gateway/src/main/java/io/shinhanlife/dap/biz/mcp/gateway/sync/RegistryMcpToolSpecificationFactory.java

@@ -52,6 +52,12 @@ public class RegistryMcpToolSpecificationFactory {
                 .name(entry.getName())
                 .description(description(entry))
                 .inputSchema(inputSchema(entry))
+                .annotations(McpSchema.ToolAnnotations.builder()
+                        .readOnlyHint(Boolean.TRUE.equals(entry.getReadOnlyHint()))
+                        .destructiveHint(Boolean.TRUE.equals(entry.getDestructiveHint()))
+                        .idempotentHint(Boolean.TRUE.equals(entry.getIdempotentHint()))
+                        .openWorldHint(Boolean.TRUE.equals(entry.getOpenWorldHint()))
+                        .build())
                 .build();
 
         return McpServerFeatures.SyncToolSpecification.builder()

dap-tool-core/src/main/java/io/shinhanlife/dap/biz/mcp/tool/annotation/McpFunction.java

@@ -39,5 +39,10 @@ public @interface McpFunction {
     // 추가: HITL 승인 체계 지원 (실행 전 사용자 승인 필요 여부)
     boolean requiresApproval() default false;
 
+    boolean readOnlyHint() default false;
+    boolean destructiveHint() default false;
+    boolean idempotentHint() default false;
+    boolean openWorldHint() default false;
+
     // 추가: 툴 별 기본 Timeout 설정 (기본 300초 = 300000ms)
 }

dap-tool-core/src/main/java/io/shinhanlife/dap/biz/mcp/tool/dto/ToolMetadata.java

@@ -58,6 +58,17 @@ public class ToolMetadata {
     @Builder.Default
     private Boolean requiresApproval = false;
 
+    @Builder.Default
+    private Boolean readOnlyHint = false;
+
+    @Builder.Default
+    private Boolean destructiveHint = false;
+
+    @Builder.Default
+    private Boolean idempotentHint = false;
+
+    @Builder.Default
+    private Boolean openWorldHint = false;
 
 
-}
+}

dap-tool-core/src/main/java/io/shinhanlife/dap/biz/mcp/tool/service/ToolRegistryHeartbeatSender.java

@@ -107,6 +107,10 @@ public class ToolRegistryHeartbeatSender {
                     meta.setVisible(isVisible);
                     meta.setIsRegistered(isRegister);
                     meta.setRequiresApproval(functionAnnotation.requiresApproval());
+                    meta.setReadOnlyHint(functionAnnotation.readOnlyHint());
+                    meta.setDestructiveHint(functionAnnotation.destructiveHint());
+                    meta.setIdempotentHint(functionAnnotation.idempotentHint());
+                    meta.setOpenWorldHint(functionAnnotation.openWorldHint());
                     
                     Map<String, String> prompts = new HashMap<>();
                     String promptText = functionAnnotation.prompt();
@@ -174,4 +178,4 @@ public class ToolRegistryHeartbeatSender {
             log.error(" [HeartbeatSender] 툴 등록 실패: {}", ex.getMessage());
         }
     }
-}
+}