在现代软件开发中，高效的通信机制是构建复杂系统的关键。MCP（Model-Controller-Proxy）架构作为一种新兴的开发模式，提供了强大的工具来实现客户端与服务器之间的高效通信。本文将通过实际代码示例，详细探讨如何使用MCP Python SDK构建一个简单的MCP Client，并介绍MCP支持的两种主要通信方式：标准输入输出（stdio）和服务器发送事件（SSE）。

一、MCP通信方式概述

MCP支持两种主要的通信方式，每种方式都有其独特的应用场景和优势。

1.1 标准输入输出（stdio）
在stdio方式中，客户端通过启动服务器子进程，并使用标准输入（stdin）和标准输出（stdout）与服务器建立双向通信。这种方式适用于本地快速集成的场景，一个服务器进程只能与启动它的客户端通信，形成1:1的关系。这种通信方式简单直接，适合在开发和测试阶段快速验证功能。

1.2 服务器发送事件（SSE）
SSE是一种基于HTTP协议的技术，允许服务器向客户端单向、实时地推送数据。与传统的轮询或长轮询相比，SSE提供了更高效的数据传输机制，减少了客户端的请求开销。在SSE方式中，服务器作为独立进程运行，客户端和服务器代码完全解耦，支持多个客户端随时连接和断开。这种方式适用于需要实时数据更新的场景，如实时监控、消息推送等。

二、使用MCP Python SDK构建MCP Client

接下来，我们将通过一个简单的示例，展示如何使用MCP Python SDK构建一个MCP Client，并实现与MCP Server的通信。

2.1 项目初始化
首先，我们需要初始化项目并安装必要的依赖。使用 uv 工具来初始化项目，并安装 mcp 库：

uv init mcp-client-demo
uv add "mcp[cli]"
pip install mcp

2.2 实现MCP Client

2.2.1 使用Stdio方式
在stdio方式下，客户端通过启动服务器子进程并与之通信。以下是一个简单的MCP Client实现示例：

import mcp

# 初始化MCP Client
client = mcp.Client()

# 列出MCP Server支持的工具
tools = client.list_tools()
print("Available tools:", tools)

# 调用指定工具
tool_name = "weather_query"
tool_args = {"city": "Beijing"}
result = client.call(tool_name, tool_args)
print(f"Result of {tool_name}: {result}")

在这个示例中，我们首先初始化了一个MCP Client实例，然后通过 list_tools 方法列出MCP Server支持的所有工具。接着，我们调用了名为 weather_query 的工具，并传递了参数 {“city”: “Beijing”} 。最终，我们打印出工具调用的结果。

2.2.2 使用SSE方式
在SSE方式下，客户端通过HTTP连接与服务器进行通信。首先，需要确保MCP Server支持SSE。以下是一个支持SSE的MCP Server示例：

from mcp import Server, SSEHandler

# 创建MCP Server
server = Server()

# 定义一个工具
@server.tool(name="weather_query")
def weather_query(city: str) -> str:
    return f"{city}的天气是晴天，温度25度。"

# 启动SSE服务器
server.start_sse(SSEHandler)

然后，客户端可以通过以下方式连接到SSE服务器并调用工具：

import mcp

# 初始化MCP Client并连接到SSE服务器
client = mcp.Client(sse_url="http://localhost:8080/sse")

# 列出MCP Server支持的工具
tools = client.list_tools()
print("Available tools:", tools)

# 调用指定工具
tool_name = "weather_query"
tool_args = {"city": "Beijing"}
result = client.call(tool_name, tool_args)
print(f"Result of {tool_name}: {result}")

在这个示例中，我们通过 mcp.Client 的构造函数指定了SSE服务器的URL。然后，客户端通过SSE连接到服务器，并调用了 weather_query 工具。

三、SSE技术详解

SSE是一种基于HTTP协议的技术，允许服务器向客户端单向、实时地推送数据。与传统的轮询或长轮询相比，SSE具有以下优势：

• 高效的数据传输：减少了客户端的请求开销，提高了数据传输效率。
• 实时性：客户端可以实时接收服务器推送的数据，无需频繁轮询。
• 简单易用：基于HTTP协议，易于实现和集成。
  在MCP架构中，SSE特别适用于需要实时数据更新的场景，如实时监控、消息推送等。通过SSE，客户端可以随时连接或断开与服务器的连接，而不会影响其他客户端的通信。

四、总结

通过本文的介绍，我们深入了解了MCP支持的两种通信方式：stdio和SSE，并通过实际代码示例展示了如何使用MCP Python SDK构建一个简单的MCP Client。Stdio方式适用于本地快速集成的场景，而SSE方式则适用于需要实时数据更新的场景。通过这些内容，读者可以更好地理解和实现MCP Client与MCP Server之间的通信和集成。

未来，随着MCP架构的不断发展和完善，我们可以预见它将在更多的领域得到应用，为软件开发带来更多的创新和突破。让我们继续探索和实践，充分利用MCP的强大能力，打造出更加高效、智能的应用系统。

往期内容

构建高效开发基石：手把手教你搭建MCP Server
API教程文档