协议版本: 2024-11-05
Model Context Protocol（MCP）为服务器提供了一种标准化方式，用于向客户端发送结构化日志消息。客户端可通过设置最低日志级别来控制日志详细程度，服务器则会发送包含严重级别、可选记录器名称以及任意可JSON序列化数据的通知。

​
用户交互模型

实现可以自由通过任何适合其需求的界面模式来公开日志记录——协议本身并不强制要求任何特定的用户交互模型。

​
能力

Servers that emit log message notifications 必须 declare the logging capability: 
{
  "capabilities": {
    "logging": {}
  }
}

​
日志级别

该协议遵循RFC 5424中定义的标准系统日志严重性级别:
级别描述使用案例
debug详细调试信息函数入口/出口点
info通用信息消息操作进度更新
notice正常但重要的事件配置更改
警告警告条件已弃用功能使用
errorError conditionsOperation failures
critical严重状况系统组件故障
alert必须立即采取行动检测到数据损坏
emergency系统不可用系统发生完全故障

​
协议消息

​
设置日志级别

To configure the minimum log level, clients 可以 send a logging/setLevel request: 请求： 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "logging/setLevel",
  "params": {
    "level": "info"
  }
}

​
日志消息通知

Servers send log messages using notifications/message notifications: 
{
  "jsonrpc": "2.0",
  "method": "notifications/message",
  "params": {
    "level": "error",
    "logger": "database",
    "data": {
      "error": "Connection failed",
      "details": {
        "host": "localhost",
        "port": 5432
      }
    }
  }
}

​
消息流

​
错误处理

Servers 应当 return standard JSON-RPC errors for common failure cases:
  • 无效日志级别: -32602 (参数无效)
  • 配置错误：-32603（内部错误）

​
实施注意事项

  1. Servers 应当:
    • 速率限制日志消息
    • 在数据字段中包含相关上下文
    • 使用一致的日志记录器名称
    • 移除敏感信息
  2. Clients 可以:
    • 在用户界面中显示日志消息
    • 实现日志过滤/搜索
    • 视觉化显示严重性
    • 持久化日志消息

​
安全性

  1. Log messages 不可 contain:
    • 凭据或密钥
    • 个人身份信息
    • 可能有助于攻击的内部系统细节
  2. Implementations 应当:
    • 限制消息速率
    • 验证所有数据字段
    • 控制日志访问
    • 监控敏感内容