Skip to main content
协议修订：2025-03-26
模型上下文协议（MCP）为服务器向客户端发送结构化日志消息提供了标准化的方式。客户端可以通过设置最低日志级别来控制日志的详细程度，服务器发送的通知中包含严重程度级别、可选的记录器名称以及任意可序列化为 JSON 的数据。

​
用户交互模型

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

​
功能

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

​
日志级别

该协议遵循 RFC 5424 中指定的标准 syslog 严重级别：
级别描述示例使用场景
debug详细的调试信息函数入口/出口点
info通用的信息性消息操作进度更新
notice正常但重要的事件配置更改
warning警告条件已弃用功能的使用
error错误条件操作失败
critical严重条件系统组件故障
alert必须立即采取行动检测到数据损坏
emergency系统不可用完全系统故障

​
协议消息

​
设置日志级别

要配置最低日志级别，客户端可以发送 logging/setLevel 请求： 请求： 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "logging/setLevel",
  "params": {
    "level": "info"
  }
}

​
日志消息通知

服务器使用 notifications/message 通知发送日志消息： 
{
  "jsonrpc": "2.0",
  "method": "notifications/message",
  "params": {
    "level": "error",
    "logger": "数据库",
    "data": {
      "错误": "连接失败",
      "详情": {
        "主机": "localhost",
        "端口": 5432
      }
    }
  }
}

​
消息流程

​
错误处理

服务器应该为常见故障情况返回标准 JSON-RPC 错误：
  • 无效的日志级别：-32602（参数无效）
  • 配置错误：-32603（内部错误）

​
实现注意事项

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

​
安全性

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