SLS MCP Server

资源发现

查看账号下可访问的 SLS 资源清单，包括 Project、Project 中的 LogStore 与 Metricstore，无需登录控制台逐个翻找。对应工具：sls_list_projects、sls_list_logstores、sls_list_metricstores。

日志分析

查询原始日志或执行 SLS SQL 分析，查看匹配日志的总数与时间分布，以及单条日志前后的上下文，无需手写查询语句或在控制台页面之间切换。对应工具：sls_get_logstore_index、sls_query_logs、sls_get_log_histogram、sls_get_context_logs。

告警诊断

查看告警规则与告警历史，并对指定告警实例分析触发原因，用于告警触发后的快速定位。对应工具：sls_list_alerts、sls_get_alert、sls_list_alert_history、sls_diagnose_alert。

步骤一：安装阿里云 CLI

SLS MCP Server 依赖阿里云 CLI 保存的 OAuth 凭证，且要求阿里云 CLI 版本不低于 3.3.0，因此先在本地安装阿里云 CLI。

Linux 和 macOS 执行以下命令即可完成一键安装：

sudo /bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"

Windows 的安装方式，以及三个系统的其他安装方式、版本指定与卸载方法，以安装/更新 CLI为准。

安装完成后，执行 aliyun version 查看版本号：输出的版本号不低于 3.3.0 才可继续；如果本机已安装旧版本，先按上述文档中的更新方式升级，再重新校验版本号。

步骤二：安装并分配 OAuth 应用（RAM 管理员一次性操作）

首次使用 OAuth 登录前，需要由 RAM 管理员按OAuth 凭证中的授权流程完成以下操作。该操作是一次性的：official-cli 应用安装完成、且 RAM 用户或角色已完成分配后，被分配的用户都可以直接使用 OAuth 登录，无需重复操作。如果 official-cli 应用已存在、且需要使用阿里云 CLI 的 RAM 用户或角色已在分配列表中，可直接进入步骤三。

1. 安装 CLI 应用：登录 RAM 控制台，在左侧导航栏选择集成管理> OAuth 应用（公测），切换到 第三方应用 页签。如果列表中没有 official-cli 应用，单击安装官方应用，选择 官方 CLI 完成安装。

2. 分配身份：进入 official-cli 应用详情页，切换到 分配 页签。单击 创建分配，将需要使用阿里云 CLI 的 RAM 用户或角色添加到授权列表。完成后，分配 页签的列表中会显示该 RAM 用户或角色。

步骤三：使用 OAuth 登录并配置凭证（Profile）

执行以下命令，会自动打开浏览器页面，完成登录认证即可。

aliyun configure --mode OAuth

配置过程中，Region 填写 cn-hangzhou 即可。SLS MCP Server 免地域访问，一份凭证配置即可跨地域访问所有 Project，该配置不影响后续可访问的 Project 范围。

默认的 Profile 名是 default。要管理多个账号或多个环境，可以通过 -p 参数指定自定义的 Profile 名。

aliyun configure --mode OAuth -p sls-test-oauth

完成登录认证后，OAuth 凭证保存在对应的 Profile，该 Profile 名就是步骤四中 --profile 参数的取值。

步骤四：将 SLS MCP Server 添加到 AI Agent

SLS MCP Server 采用标准 stdio 传输方式，可以接入各类支持 MCP 协议的 AI Agent，下面以 Qoder、Codex、Claude Code、OpenClaw、Hermes Agent 为例介绍配置方法。以下命令和配置均以 Profile 名 default 为例；如果在步骤三中通过 -p 指定了自定义 Profile 名，将 --profile 的取值替换为该名称。

Qoder

# 添加 MCP Server
qodercli mcp add \
  --scope user \
  --transport stdio \
  alibabacloud-sls \
  -- uvx alibabacloud-sls-mcp-proxy@latest --profile default

# 查看已添加的 MCP Server 列表
qodercli mcp list

Codex

# 添加 MCP Server
codex mcp add alibabacloud-sls \
  -- uvx alibabacloud-sls-mcp-proxy@latest --profile default

# 查看已添加的 MCP Server 列表
codex mcp list

Claude Code

# 添加 MCP Server（--scope user 表示对当前用户的所有项目生效）
claude mcp add --scope user alibabacloud-sls \
  -- uvx alibabacloud-sls-mcp-proxy@latest --profile default

# 查看已添加的 MCP Server 列表
claude mcp list

OpenClaw

# 添加 MCP Server
openclaw mcp add alibabacloud-sls \
  --command uvx \
  --arg alibabacloud-sls-mcp-proxy@latest \
  --arg --profile \
  --arg default

# 查看已添加的 MCP Server 列表
openclaw mcp list

Hermes Agent

Hermes Agent 通过配置文件管理 MCP Server。编辑（如不存在则创建）用户目录下的 ~/.hermes/config.yaml 文件，添加如下内容：

mcp_servers:
  alibabacloud-sls:
    command: uvx
    args:
      - alibabacloud-sls-mcp-proxy@latest
      - --profile
      - default

保存后重启 Hermes Agent，或在会话中执行 /reload-mcp 刷新 MCP 配置。

其他 MCP 客户端

对于 Cursor、Cline、Cherry Studio 等支持通过 JSON 文件配置 MCP Server 的客户端，可以在其 MCP 配置文件中添加如下内容：

{
  "mcpServers": {
    "alibabacloud-sls": {
      "command": "uvx",
      "args": [
        "alibabacloud-sls-mcp-proxy@latest",
        "--profile",
        "default"
      ]
    }
  }
}

步骤五：验证连接

打开 AI Agent，直接输入一句自然语言进行验证，例如：

列出我可以访问的 SLS Project

如果 AI 能正常返回 Project 列表，说明 SLS MCP Server 已成功接入。如果没有返回 Project 列表，先执行对应客户端的 mcp list 命令确认 SLS MCP Server 已添加成功，再用 MCP Inspector 查看工具列表与调用参数，缩小问题范围。

示例一：查找资源

列出我在杭州地域可以访问的 SLS Project

AI 会调用 sls_list_projects 返回 Project 列表，之后可以继续追问：

Project nginx-prod 下面有哪些 Logstore？

AI 会调用 sls_list_logstores 列出对应的 LogStore。

示例二：查询日志

查询 Project nginx-prod 的 access-log 最近 1 小时包含 error 的日志

AI 会调用 sls_query_logs，自动使用 now-1h 到 now 这样的相对时间范围完成查询。要了解日志量的分布情况，可以继续追问：

这些日志大概有多少条？按时间分布给我看看

AI 会调用 sls_get_log_histogram 返回匹配日志的总数和时间分布。

示例三：查看日志上下文

排查问题时，单条日志往往信息不足，可以让 AI 拉取上下文：

帮我看下这条报错日志前后 20 行的上下文

AI 会使用上一步查询结果中的 __pack_id__ 和 __pack_meta__，调用 sls_get_context_logs 返回目标日志前后的完整上下文。

示例四：诊断告警

我的 cpu-high 告警最近 24 小时为什么触发了？帮我诊断一下

AI 会调用 sls_diagnose_alert，汇总该告警实例的生命周期、严重级别、评估原因和查询证据，帮助快速定位触发原因。

sls_list_projects

sls_list_logstores

sls_list_metricstores

sls_get_logstore_index

sls_query_logs

sls_get_log_histogram

与 sls_query_logs 不同，本工具的 from、to 只接受 Unix 秒，不支持 now-1h 等相对时间；query 只支持查询表达式，不支持 SQL 分析。

sls_get_context_logs

sls_list_alerts

sls_get_alert

sls_list_alert_history

sls_diagnose_alert