MCP clients

MCP 客户端与服务器核心概念笔记

💡 核心概念 (Key Concepts)

• 客户端 (Client) 的作用:
• 作为服务器与 MCP 服务器之间的通信媒介。
• 是访问服务器所有工具的接入点。
• MCP 传输无关性 (Transport Agnostic):
• 客户端和服务器可以利用多种不同的协议进行通信。
• 常见连接方式包括：标准输入/输出 (I/O)、HTTP、WebSockets 等。
• 通信机制:
• 客户端和服务器通过交换符合 MCP 规范定义的各种消息进行通信。

🛠️ 关键消息类型 (Key Message Types)

**1. 工具发现 (Tool Discovery):**

• 列出工具请求 (List Tools Request):
• 发送方：客户端 → 接收方：服务器。
• 目的：请求服务器列出其提供的所有工具。
• 列出工具结果 (List Tools Result):
• 发送方：服务器 → 接收方：客户端。
• 目的：返回服务器所能提供的工具列表。

**2. 工具执行 (Tool Execution):**

• 调用工具请求 (Call Tool Request):
• 发送方：客户端 → 接收方：服务器。
• 目的：请求服务器使用特定工具并传入特定参数。
• 调用工具结果 (Call Tool Result):
• 发送方：服务器 → 接收方：客户端。
• 目的：包含工具执行后的实际运行结果。

🔄 完整工作流程示例 (Workflow Example)

（以用户提问“我有哪些仓库？”为例，涉及用户 → 服务器 → 客户端 → MCP 服务器 → GitHub → 返回用户）

• 工具列表获取:
• 服务器需要工具列表 → 服务器请求客户端获取工具列表。
• 客户端 → 服务器发送：列出工具请求。
• 服务器 → 客户端返回：列出工具结果。
• 工具调用发起:
• 服务器结合用户查询和工具列表 → 决定调用工具 → 请求客户端执行工具。
• 客户端 → 服务器发送：调用工具请求（包含参数）。
• 工具执行与结果返回:
• 服务器执行工具（如调用 GitHub API） → 获得数据。
• 服务器 → 客户端返回：调用工具结果（包含数据）。
• 最终响应生成:
• 客户端将工具结果传递给服务器。
• 服务器将工具结果封装在用户消息中 → 发送给 AI（如 Claude）。
• AI 利用结果生成最终答案 → 返回给服务器 → 服务器发送给用户。

Takeaways

• 客户端是连接服务器与MCP服务器的通信媒介和所有工具的接入点。
• MCP 具有传输无关性，支持多种协议进行通信，包括标准输入/输出 (I/O)、HTTP 和 WebSockets 等。
• 通信机制基于交换符合 MCP 规范定义的各种消息，主要分为工具发现和工具执行两大类。
• 工具发现流程包括客户端向服务器发送“列出工具请求”，服务器返回“列出工具结果”。
• 工具执行流程包括客户端发送“调用工具请求”（含参数），服务器返回“调用工具结果”（含执行数据）。