FastMCP项目中客户端日志功能的正确使用方法

在FastMCP项目2.2.3版本中，开发者在使用客户端日志功能时可能会遇到一个常见问题：文档中提供的示例代码引用了已经不存在的LogLevel类。这个问题源于项目版本迭代过程中文档未及时更新，导致用户按照文档操作时会遇到导入错误。

问题背景

FastMCP是一个基于Python的现代化客户端-服务器框架，它提供了强大的日志功能帮助开发者调试和监控应用运行状态。在1.6.0版本的MCP核心中，日志系统的实现方式发生了变化，但相关文档未能同步更新。

正确的实现方式

实际上，在FastMCP 2.2.3版本中，日志级别不再通过单独的LogLevel类来定义，而是直接使用Python标准库中的logging模块级别。以下是修正后的实现示例：

import logging
from mcp.client.session import LoggingFnT

def my_log_handler(level: int, message: str, logger_name: str | None):
    level_name = logging.getLevelName(level)
    print(f"[Server Log - {level_name}] {logger_name or 'default'}: {message}")

client_with_logging = Client(
    "my_server.py",
    log_handler=my_log_handler
)

关键变化说明

1. 移除了对LogLevel类的依赖，改为使用Python内置的logging级别
2. 日志级别参数现在直接使用整数类型，与Python标准库保持一致
3. 可以通过logging.getLevelName()方法将级别数值转换为可读的名称

最佳实践建议

1. 对于生产环境，建议将日志输出到文件而非控制台
2. 可以结合Python的logging模块创建更复杂的日志处理流程
3. 考虑添加日志过滤功能，只记录特定级别的消息
4. 对于分布式系统，可以扩展日志处理器将日志发送到集中式日志服务

总结

FastMCP项目的日志功能虽然接口有所变化，但变得更加标准化和灵活。开发者现在可以充分利用Python生态中成熟的日志处理方案，构建更强大的日志监控系统。这个变化也体现了项目向Python标准看齐的设计理念，降低了用户的学习成本。

对于从旧版本升级的用户，建议检查所有使用日志功能的代码并进行相应调整。新用户则可以直接采用新的实现方式，享受更简洁的API设计。