// 這就是一個簡單的工具 - 加法計算器
@MCPService
public class CalculatorTool {
    public int add(int a, int b) {
        return a + b; // AI現在會做加法了！
    }
}

??? 架構層次：
├── 通信層 (WebSocket + HTTP) - 提供雙協議支持
├── 協議層 (MCP協議解析) - 標準化AI交互
├── 工具層 (業務邏輯封裝) - 可擴展的工具生態
├── 集成層 (外部系統對接) - 企業系統連接
└── 安全層 (認證授權) - 企業級安全

??? 技術選型：
│   Spring Boot 3.x - 現代化應用框架
│   WebSocket - 實時雙向通信
│   Jackson - JSON序列化
│   Maven - 依賴管理
│   Lombok - 代碼簡化
│   Validation - 參數校驗

?? 架構層次（從上到下）：
├── 接入層（房子的門窗）
│   ├── WebSocket通信 (實時對講機)
│   └── HTTP REST (門鈴和郵箱)
├── 協議層（房子的管家）  
│   ├── MCP協議解析（理解客人需求）
│   └── 請求路由（指引客人到正確房間）
├── 核心層（房子的功能區）
│   ├── 工具管理（工具房）
│   ├── 資源管理（書房和檔案室）
│   └── 會話管理（會客記錄）
├── 工具層（各種家電）
│   ├── 數學工具（計算器）
│   ├── 文本分析（文檔掃描儀）
│   ├── 業務工具（專業設備）
│   └?── 自定義工具（DIY工具）
└── 持久層（地下室倉庫）
    ├── 配置管理（設備說明書）
    └── 狀態存儲（使用記錄）

/**
 * MCP協議處理器 - 就像一位專業的管家
 * 他記得每個家庭成員（工具）的能力
 * 知道如何安排訪客（請求）的行程
 */
@Service
publicclass MCPServer {
    public MCPResponse handleRequest(MCPRequest request) {
        // 管家看到客人來了，先判斷客人要找誰
        if (request instanceof ToolsListRequest) {
            // "哦，您想看看我們家里有哪些工具？這邊請..."
            return handleToolsList((ToolsListRequest) request);
        } elseif (request instanceof ToolsCallRequest) {
            // "您想使用某個工具？讓我帶您去工具房..."
            return handleToolsCall((ToolsCallRequest) request);
        }
        // ... 其他情況
    }
}

/**
 * 工具管理器 - 就像工具房的智能管理系統
 * 他知道每個工具放在哪里、怎么用、注意事項
 */
public class ToolManager {
    // 這個工具架是線程安全的，多人同時取工具也不會混亂
    private Map<String, MCPTool> tools = new ConcurrentHashMap<>();
    
    // 添加新工具就像往架子上放新設備
    public void registerTool(String name, MCPTool tool) {
        tools.put(name, tool);
        log.info("新工具 {} 已上架，現在共有 {} 種工具", name, tools.size());
    }
}

/**
 * WebSocket處理器 - 就像家里的內部電話總機
 * 確保每個房間都能實時通信
 */
@Component
publicclass MCPWebSocketHandler implements WebSocketHandler {
    
    @Override
    public void afterConnectionEstablished(WebSocketSession session) {
        // "叮咚~ 新的分機號XXX已接通"
        log.info("新的客戶端連接: {}", session.getId());
    }
    
    @Override
    public void handleMessage(WebSocketSession session, WebSocketMessage<?> message) {
        // "分機XXX說：...，讓我處理一下"
        processMessage(session, message.getPayload().toString());
    }
}