MCP Kotlin Minimal Client Server Sample

🚀 MCP（モデルコンテキストプロトコル）最小Kotlinクライアントサーバーサンプル

このプロジェクトは、Model Context Protocol (MCP) を使用したクライアントとサーバー間のやり取りをデモンストレーションする簡単な天気ツールです。専らデモ用です。

ユーザー：「東京の天気はどうですか？」
レスポンス：「東京の天気は晴れです。」

これは、mcp-minimal-client-weather-server-sample のKotlinバージョンです。

クライアント：src/main/kotlin/Client.kt
サーバー：server.main.kts

🚀 クイックスタート

このサンプルを使用することで、MCPを用いたクライアントとサーバー間のやり取りを体験できます。以下に、主なコンポーネントとその場所を示します。

• クライアント: 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: 显示最终响应