MCP Kotlin Minimal Client Server Sample

🚀 MCP（模型上下文協議）最小 Kotlin 客戶端服務器示例

這是一個簡單的天氣工具示例，主要用於演示基於 Model Context Protocol (MCP) 的客戶端與服務器之間的交互過程。此示例僅作演示用途，幫助大家瞭解 MCP 的基本應用。

當用戶詢問“東京的天氣怎麼樣？”時，系統會響應“東京的天氣很晴朗。”

本示例為 Kotlin 版本，其參考的原項目為 mcp-minimal-client-weather-server-sample 。

客戶端代碼位於：src/main/kotlin/Client.kt
服務器代碼位於：server.main.kts

🚀 快速開始

項目結構說明

• 客戶端：代碼存於 src/main/kotlin/Client.kt ，負責與用戶交互以及和服務器通信。
• 服務器：代碼存於 server.main.kts ，用於處理客戶端的請求並返回相應結果。

交互流程

初始化和工具發現


sequenceDiagram
    autonumber

    participant User
    participant ClientApp as ClientApp (Host)<br>在本地 PC 上
    participant LLM as LLM（例如，Claude）<br>遠程服務
    participant MCPClient as MCPClient（內部組件）<br>在客戶端應用的本地 PC 上
    participant MCPServer as MCPServer（例如，工具服務器）<br>在本地 PC 上

    Note over User, MCPServer: 用戶啟動客戶端應用程序，發起與 MCPServer 的連接

    ClientApp->>+MCPClient: 指令準備連接到服務器
    MCPClient->>-MCPServer: 連接建立（WebSocket 或 HTTP 長輪詢）

    Note over MCPClient, MCPServer: 客戶端和服務器之間的通信通道已建立

    ClientApp->>+MCPClient: 指令獲取可用工具列表（session.list_tools()）
    MCPClient->>+MCPServer: 工具列表請求（tools/list）
    MCPServer-->-MCPClient: 返回可用工具列表
    MCPClient-->>-ClientApp: 通知工具列表已獲取

    Note over ClientApp: 顯示工具列表或在控制檯輸出工具信息

此流程展示了用戶啟動客戶端應用後，客戶端與服務器建立連接並獲取可用工具列表的過程。

工具執行流程


sequenceDiagram
    autonumber

    participant User
    participant ClientApp as ClientApp（Host）<br>在本地 PC 上
    participant LLM as LLM（例如，Claude）<br>遠程服務
    participant MCPClient as MCPClient（內部組件）<br>在客戶端應用的本地 PC 上
    participant MCPServer as MCPServer（例如，工具服務器）<br>在本地 PC 上

    Note over User: 用戶輸入查詢“東京的天氣怎麼樣？”

    ClientApp->>LLM: 發送用戶查詢以獲取初步響應
    LLM-->>ClientApp: 返回需要調用工具的指令

    ClientApp->>+MCPClient: 指令執行工具調用（session.call_tool()）
    MCPClient->>+MCPServer: 工具調用請求（tools/call）

    Note over MCPServer: 執行get_weather函數並返回結果
    MCPServer-->>-MCPClient: 返回天氣信息

    MCPClient-->>-ClientApp: 通知工具執行結果

    ClientApp->>LLM: 發送工具執行結果以獲取最終響應
    LLM-->>ClientApp: 返回最終答案

    ClientApp->>User: 顯示最終響應

該流程呈現了用戶輸入查詢後，客戶端與 LLM、服務器之間的交互，最終獲取並顯示查詢結果的過程。