阿里云日志服务 (SLS) 的 MCP 查询工具，支持通过 AI 助手直接访问和分析云日志数据。

安装配置

将以下配置添加到你的 MCP 客户端配置文件中：

{
  "mcpServers": {
    "aliyun-sls": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ]
    }
  }
}

前置要求

• Node.js >= 18.0.0
• 阿里云 RAM 子账号的 AccessKey（需具备 SLS 只读权限）

工具列表

set_credentials

设置阿里云访问凭证，必须在使用其他工具前调用。

| 参数 | 说明 | |------|------| | access_key_id | 阿里云 AccessKey ID | | access_key_secret | 阿里云 AccessKey Secret | | endpoint | SLS 服务端点，默认 cn-hangzhou.log.aliyuncs.com |

常用端点：

• 华东1（杭州）：cn-hangzhou.log.aliyuncs.com
• 华东2（上海）：cn-shanghai.log.aliyuncs.com
• 华北2（北京）：cn-beijing.log.aliyuncs.com
• 华南1（深圳）：cn-shenzhen.log.aliyuncs.com

list_projects

列出当前凭证可访问的所有 SLS 项目。

list_logstores

列出指定项目下的所有日志库。

| 参数 | 说明 | |------|------| | project_name | 项目名称 |

get_logs

查询日志，支持 SLS 查询语法。

| 参数 | 说明 | |------|------| | project_name | 项目名称 | | logstore_name | 日志库名称 | | from_time | 开始时间（Unix 时间戳，秒） | | to_time | 结束时间（Unix 时间戳，秒） | | query | 查询语句，默认 * | | page | 页码，默认 1 | | size | 每页数量，默认 100 |

查询示例：

• * 全部日志
• error 包含 error 的日志
• status:500 status 字段为 500 的日志
• * | select count(*) SQL 分析

query_context_logs

获取指定日志的上下文，用于追溯完整请求链路。

| 参数 | 说明 | |------|------| | project_name | 项目名称 | | logstore_name | 日志库名称 | | pack_id | 日志元数据中的 tag:pack_id 字段 | | pack_meta | 日志元数据中的 pack_meta 字段 | | back_lines | 向前获取行数，默认 30 | | forward_lines | 向后获取行数，默认 30 |

get_log_histogram

获取日志时间分布直方图，用于识别异常时段和流量峰值。

| 参数 | 说明 | |------|------| | project_name | 项目名称 | | logstore_name | 日志库名称 | | from_time | 开始时间（Unix 时间戳，秒） | | to_time | 结束时间（Unix 时间戳，秒） | | query | 查询语句，默认 * |

使用场景

• 问题排查：通过自然语言描述问题，AI 自动查询相关错误日志
• 日志分析：统计日志趋势、识别异常模式
• 链路追踪：根据单条日志追溯完整请求上下文
• 运维监控：了解系统日志分布，发现流量峰值或故障时段

许可证

MIT