MCP（模型上下文协议）最小 Kotlin 客户端服务器示例

一个简单的天气工具，演示使用 Model Context Protocol (MCP) 的客户端与服务器之间的交互。仅供演示用途。

用户："东京的天气怎么样？"
响应："东京的天气很晴朗。"

这是一个 Kotlin 版本的 mcp-minimal-client-weather-server-sample

客户端：src/main/kotlin/Client.kt
服务器：server.main.kts

图 1：初始化和工具发现

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: 显示工具列表或在控制台输出工具信息

图 2：工具执行流程

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: 显示最终响应