Skip to main content
协议修订:2024-11-05
Model Context Protocol (MCP) 提供了一种标准化的方式,使服务器可以向客户端发送结构化的日志消息。客户端可以通过设置最低日志级别来控制日志的详细程度,服务器发送的通知中将包含严重级别、可选的记录器名称以及任意可序列化为 JSON 的数据。

用户交互模型

实现方可以自由选择适合其需求的任何接口模式来暴露日志功能——协议本身不强制要求任何特定的用户交互模型。

功能能力

发送日志消息通知的服务器 必须 声明 logging 功能:

日志级别

该协议遵循 RFC 5424 中指定的标准 syslog 严重级别:

协议消息

设置日志级别

要配置最低日志级别,客户端 可以 发送 logging/setLevel 请求: 请求:

日志消息通知

服务器使用 notifications/message 通知发送日志消息:

消息流程

错误处理

服务器 应该 为常见的失败情况返回标准的 JSON-RPC 错误:
  • 无效的日志级别:-32602(参数无效)
  • 配置错误:-32603(内部错误)

实现考虑

  1. 服务器 应该
    • 对日志消息进行速率限制
    • 在 data 字段中包含相关上下文
    • 使用一致的记录器名称
    • 移除敏感信息
  2. 客户端 可以
    • 在 UI 中显示日志消息
    • 实现日志过滤/搜索
    • 以视觉方式显示严重级别
    • 持久化日志消息

安全性

  1. 日志消息 不得 包含:
    • 凭据或密钥
    • 个人身份信息
    • 可能帮助攻击者的内部系统细节
  2. 实现 应该
    • 对消息进行速率限制
    • 验证所有数据字段
    • 控制日志访问
    • 监控敏感内容