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、服务器之间的交互，最终获取并显示查询结果的过程。