refactor(logging): 补齐核心模块日志与中文注释约束

common-agent-mcp/src/main/java/com/bruce/mcp/controller/McpImportController.java

@@ -11,6 +11,7 @@ import com.bruce.mcp.vo.McpCapabilityVO;
 import com.bruce.mcp.vo.McpServerVO;
 import com.bruce.mcp.vo.McpWorkspaceVO;
 import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -21,6 +22,12 @@ import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
 
+/**
+ * MCP 接入控制器。
+ * <p>
+ * 负责导入服务、查询服务与能力、以及工作台聚合视图查询。
+ */
+@Slf4j
 @RestController
 @RequestMapping("/api/mcp")
 @RequiredArgsConstructor
@@ -33,16 +40,19 @@ public class McpImportController {
 
     @PostMapping("/import")
     public RequestResult<Boolean> importServer(@RequestBody McpImportDTO request) {
+        log.info("MCP服务导入开始，serverCode={}, importType={}", request.getServerCode(), request.getImportType());
         return RequestResult.success(mcpImportService.importServer(request));
     }
 
     @GetMapping("/servers")
     public RequestResult<List<McpServerVO>> listServers() {
+        log.info("MCP服务列表查询开始");
         return RequestResult.success(mcpServerService.listServers());
     }
 
     @GetMapping("/servers/{serverId}/capabilities")
     public RequestResult<List<McpCapabilityVO>> listCapabilities(@PathVariable("serverId") Long serverId) {
+        log.info("MCP能力列表查询开始，serverId={}", serverId);
         return RequestResult.success(mcpCapabilityService.listByServerId(serverId));
     }
 
@@ -51,16 +61,19 @@ public class McpImportController {
      */
     @GetMapping("/servers/code/{serverCode}/capabilities")
     public RequestResult<List<McpCapabilityVO>> listCapabilitiesByServerCode(@PathVariable("serverCode") String serverCode) {
+        log.info("MCP能力列表按编码查询开始，serverCode={}", serverCode);
         return RequestResult.success(mcpCapabilityService.listByServerCode(serverCode));
     }
 
     @PostMapping("/capabilities/save")
     public RequestResult<Boolean> saveCapability(@RequestBody McpCapabilitySaveDTO request) {
+        log.info("MCP能力保存开始，serverId={}, capabilityCode={}", request.getServerId(), request.getCapabilityCode());
         return RequestResult.success(mcpCapabilityService.saveCapability(request));
     }
 
     @GetMapping("/workspace")
     public RequestResult<McpWorkspaceVO> workspace(@RequestParam("serverId") Long serverId) {
+        log.info("MCP工作台查询开始，serverId={}", serverId);
         return RequestResult.success(mcpWorkspaceService.getWorkspace(serverId));
     }
 }