FastMCP高级特性之Message Handling

消息

前面讲到,服务端可以发送消息。对于发送的消息,可以使用自定义消息处理器处理 MCP 消息、请求和通知。

MCP 客户端可以从服务器接收各种类型的消息,包括需要响应的请求和不需要响应的通知。消息处理器提供了一种统一的方式来处理所有这些消息。

Function-Based Handler

处理消息最简单的方法是使用一个接收所有消息的函数:

python 复制代码
from fastmcp import Client

async def message_handler(message):
    """Handle all MCP messages from the server."""
    if hasattr(message, 'root'):
        method = message.root.method
        print(f"Received: {method}")
        
        # Handle specific notifications
        if method == "notifications/tools/list_changed":
            print("Tools have changed - might want to refresh tool cache")
        elif method == "notifications/resources/list_changed":
            print("Resources have changed")

client = Client(
    "my_mcp_server.py",
    message_handler=message_handler,
)

Message Handler Class

为了实现细粒度的目标定位,FastMCP 提供了一个MessageHandler类,您可以通过子类化该类来利用特定的钩子:

python 复制代码
from fastmcp import Client
from fastmcp.client.messages import MessageHandler
import mcp.types

class MyMessageHandler(MessageHandler):
    async def on_tool_list_changed(
        self, notification: mcp.types.ToolListChangedNotification
    ) -> None:
        """Handle tool list changes specifically."""
        print("Tool list changed - refreshing available tools")

client = Client(
    "my_mcp_server.py",
    message_handler=MyMessageHandler(),
)

Available Handler Methods

python 复制代码
Message Handler Methods
​
on_message(message) -> Any MCP message
Called for ALL messages (requests and notifications)
​
on_request(request) -> mcp.types.ClientRequest
Called for requests that expect responses
​
on_notification(notification) -> mcp.types.ServerNotification
Called for notifications (fire-and-forget)
​
on_tool_list_changed(notification) -> mcp.types.ToolListChangedNotification
Called when the server's tool list changes
​
on_resource_list_changed(notification) -> mcp.types.ResourceListChangedNotification
Called when the server's resource list changes
​
on_prompt_list_changed(notification) -> mcp.types.PromptListChangedNotification
Called when the server's prompt list changes
​
on_progress(notification) -> mcp.types.ProgressNotification
Called for progress updates during long-running operations
​
on_logging_message(notification) -> mcp.types.LoggingMessageNotification
Called for log messages from the server

示例: 处理工具变更消息

python 复制代码
from fastmcp.client.messages import MessageHandler
import mcp.types

class ToolCacheHandler(MessageHandler):
    def __init__(self):
        self.cached_tools = []
    
    async def on_tool_list_changed(
        self, notification: mcp.types.ToolListChangedNotification
    ) -> None:
        """Clear tool cache when tools change."""
        print("Tools changed - clearing cache")
        self.cached_tools = []  # Force refresh on next access

client = Client("server.py", message_handler=ToolCacheHandler())

处理请求

虽然消息处理器会接收服务器发起的请求,但对于大多数用例,你应该改用专用的回调参数:

bash 复制代码
Sampling requests: 使用 sampling_handler
Progress requests: 使用 progress_handler
Log requests: 使用 log_handler

消息处理器主要用于监控和处理通知,而非响应请求。

相关推荐
VIP_CQCRE37 分钟前
GPT Image 2.6 商品图换背景后悬浮?接触阴影、透明区域与反射验收
图像处理·人工智能·ai·电商
Danny转行做跨境1 小时前
跨境数据CLI怎么用? 一个命令行调61个接口实录
跨境电商·mcp·sorftime
wuyk5551 小时前
Python办公自动化-第01讲-环境搭建与自动化认知
python·自动化·pyqt
泯泷2 小时前
别再傻傻地喂文件了,大厂都在偷偷给AI建这种“专属图书馆”
人工智能
oak隔壁找我2 小时前
一款运行在 DSH(DeepSeek Harness)中的类 Postman HTTP 接口调试插件
人工智能·程序员
高洁012 小时前
数字孪生与计算机视觉:让机器看懂现场
人工智能·python·机器学习·transformer·迁移学习
ComPDFKit2 小时前
RAG 回答只显示 PDF 文件名?用 Python 保留引用页码
开发语言·python·pdf·rag
Flynt2 小时前
我让 AI 给掘金首页做了次性能体检:LCP 8.9 秒是真的,但它判读错了一处
chrome·性能优化·mcp
Csvn3 小时前
如果明天供应商涨价 3 倍?三层解耦,换模型只改一行配置(C05)
人工智能·aigc·agent
在所不辞兄3 小时前
为什么数字孪生驱动的产线标定需要在线更新机制,而不能一次标定后长期沿用?
人工智能·神经网络·其他·算法·机器学习