aliyun-sls-mcp
阿里云 SLS 日志查询 MCP Server —— 让 AI 助手(Cursor / Claude Desktop)直接用自然语言查询阿里云日志服务,告别手动翻控制台。
支持函数计算 FC、SAE 微服务、ECS、ACK 容器、API 网关、RDS 慢查询等所有已接入 SLS 的日志源。多地域并行查询,只读安全,零代码接入,npx 一行启动。
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चGitHub | npm | 阿里云 SLS 文档
你有没有遇到过这种情况:线上出了问题,要去阿里云控制台一页页翻日志,又慢又麻烦?
aliyun-sls-mcp 让你可以在 Cursor 或 Claude Desktop 的对话框里,直接用自然语言查询 SLS 日志:
"查一下 my-project 项目最近 15 分钟的错误日志"
"统计一下最近一小时各接口的报错次数"
"帮我排查今天上午 11 点左右 支付服务的 timeout 问题"
AI 会自动调用 SLS API 查出日志,帮你分析问题。
只要你的服务日志写入了阿里云 SLS,就可以用本工具查询。 以下是常见场景:
阿里云函数计算默认将函数执行日志(包括 console.log 输出、错误堆栈、冷启动信息等)持久化到 SLS。
在 FC 控制台 → 函数详情 → 日志,可以看到对应的 SLS Project 和 Logstore,将它们填入对话即可:
查询 fc-log-project aliyun-fc-cn-shenzhen-xxx-log logstore 最近 30 分钟内 my-function 函数的错误日志
注意:FC 日志不包含
__pack_meta__字段,无法使用get_context_logs,可改用query_logs按请求 ID 或__tag__:__pack_id__追踪同一次调用的完整日志。
SAE 支持将应用的标准输出(stdout/stderr)投递到 SLS。开启后可查询所有实例的日志,无需逐台登录。
在 SAE 控制台 → 应用详情 → 日志管理 → 日志采集,配置投递到 SLS 后,即可通过本工具查询:
查询 sae-log-project sae-app-stdout-store 中 my-app 最近 1 小时的日志
通过阿里云 Logtail 采集器,可以将 ECS 上任意文件日志(如 Nginx 日志、应用日志)采集到 SLS。配置完成后即可查询:
查询 my-nginx-project nginx-access-log 中最近 1 小时状态码为 5xx 的请求
ACK 集群可配置将 Pod 日志(容器标准输出)采集到 SLS,支持按 namespace、Pod 名称等字段过滤:
查询 k8s-log-project k8s-stdout 中 namespace 为 production,pod 包含 payment 的最近 15 分钟错误日志
阿里云 API 网关、SLB 负载均衡、CDN 等产品支持将访问日志自动投递到 SLS,可用于分析流量、排查 4xx/5xx 错误:
统计 apigw-log-project access-log 最近 1 小时各 API 路径的请求量和平均延迟
RDS 审计日志和慢查询日志也可投递到 SLS,配合 SQL 分析功能可快速定位慢查询:
查询 rds-log-project rds-slowquery-log 最近 1 天执行时间超过 1 秒的慢 SQL,按执行次数排序
AccessKey 是访问阿里云 API 的凭证,类似账号密码,请妥善保管,不要泄露。
最佳实践:建议创建一个子 RAM 用户,只授予
AliyunLogReadOnlyAccess权限,而不是使用主账号的 AccessKey,这样即使 Key 泄露也不会影响其他服务。
根据你使用的 AI 工具,找到对应的配置文件并编辑:
Cursor
Claude Desktop
在配置文件中添加以下内容(如果文件不存在就新建,如果已有内容就在 mcpServers 里追加):
{
"mcpServers": {
"aliyun-sls": {
"command": "npx",
"args": ["-y", "aliyun-sls-mcp"],
"env": {
"ALIBABA_CLOUD_ACCESS_KEY_ID": "你的AccessKeyId",
"ALIBABA_CLOUD_ACCESS_KEY_SECRET": "你的AccessKeySecret",
"SLS_REGIONS": "cn-hangzhou,cn-shenzhen"
}
}
}
}
把以下内容替换成你自己的:
你的AccessKeyId → 第一步获取的 AccessKey ID你的AccessKeySecret → 第一步获取的 AccessKey Secretcn-hangzhou,cn-shenzhen → 你的 SLS 数据所在地域,多个用英文逗号分隔,只有一个地域也可以直接填单个,如 cn-shenzhen地域 ID 怎么查?
登录 阿里云 SLS 控制台,进入你的 Project,URL 里会有地域信息,如 cn-shenzhen。也可以参考本文末尾的支持地域列表。
保存配置文件后,完全退出并重新打开 Cursor 或 Claude Desktop。
重启后,在对话框输入以下内容验证是否配置成功:
帮我列出所有 SLS 项目
如果返回了你的项目列表,说明配置成功!
配置成功后,你可以用自然语言告诉 AI 你想做什么,AI 会自动调用合适的工具:
发现资源
列出所有 SLS 项目(会查询所有配置的地域)
列出深圳地域的 SLS 项目
列出 my-project 项目下所有的日志库
查询日志
查询 my-project 项目 app-logs 日志库最近 15 分钟的错误日志
查找 order-service 最近 1 小时内包含 "timeout" 的日志
查询 cn-shanghai 地域 payment-project 项目 order-logs 中最近 30 分钟的日志
统计分析
统计 my-project 最近 1 小时各接口的报错次数,按数量排序
查看 my-project app-logs 最近 1 小时的日志量分布,找出流量高峰时间点
统计今天各函数的调用量和平均耗时
问题排查
帮我排查 2026-03-19 11:00 到 11:30 之间 payment 函数出现的 SLOW SQL 问题
查一下刚才那条报错日志的前后 20 条日志,看看完整的执行链路
list_projects — 列出项目列出一个或多个地域下的所有 SLS Project。
list_logstores — 列出日志库列出某个 Project 下的所有 Logstore。
query_logs — 查询日志按时间范围和过滤条件查询日志,适合错误排查、接口追踪等场景。
时间范围格式: 1m 5m 15m 30m 1h 2h 6h 12h 1d 3d 7d
SLS 查询语法示例:
* # 所有日志
level: ERROR # 错误级别日志
content: timeout # 包含 timeout 的日志
level: ERROR AND status: 500 # 组合条件(AND 连接)
level: ERROR OR level: WARN # 任一条件(OR 连接)
NOT level: INFO # 排除 INFO 日志
requestId: "abc-123-xyz" # 按请求 ID 追踪
query_logs_sql — SQL 分析对日志执行 SQL 查询,支持聚合、统计、分组,适合趋势分析和问题统计。
SQL 示例:
-- 统计各函数调用量,按数量降序
SELECT functionName, count(*) as total
FROM my-logstore
GROUP BY functionName
ORDER BY total DESC
-- 统计各状态码数量
SELECT statusCode, count(*) as cnt
FROM my-logstore
WHERE statusCode != ''
GROUP BY statusCode
ORDER BY cnt DESC
-- 统计最近 1 小时每分钟的日志量趋势
SELECT date_trunc('minute', __time__) as t, count(*) as cnt
FROM my-logstore
GROUP BY t
ORDER BY t
get_log_histogram — 日志分布图获取某段时间内日志量的分布,用于快速定位流量异常或错误高峰时间点。
输出示例:
2026/3/19 11:03:00 ███████████████████░░░░░░░░░░░ 1996
2026/3/19 11:04:00 ███████████████████████░░░░░░░ 2379 ← 流量高峰
2026/3/19 11:05:00 ████████████████░░░░░░░░░░░░░░ 1670
get_context_logs — 上下文日志获取某条日志前后的若干条日志,还原事件发生前后的完整执行链路。
注意:此工具需要日志包含
__tag__:__pack_meta__字段。阿里云函数计算(FC)的日志通常没有该字段,可以改用query_logs按__tag__:__pack_id__过滤同一批次的日志来达到类似效果。
Q:配置后 AI 说连不上 / 工具调用失败?
cn-shenzhen,不是 shenzhen)AliyunLogReadOnlyAccess 权限node -v 检查)Q:提示 "No SLS projects found" 但我确实有项目?
可能是地域填错了。登录 SLS 控制台确认你的 Project 所在地域,然后告诉 AI:
查询 cn-shenzhen 地域的 SLS 项目
Q:SLS_REGIONS 只能填一个地域吗?
不是,SLS_REGIONS 同时支持单个或多个地域:
# 单个地域
SLS_REGIONS=cn-shenzhen
# 多个地域(英文逗号分隔)
SLS_REGIONS=cn-shenzhen,cn-hangzhou,cn-beijing
不填时默认使用 cn-hangzhou。
Q:查不到 FC 函数计算的上下文日志?
FC 日志不包含 __pack_meta__ 字段,无法使用 get_context_logs。可以这样替代:
查询 my-project fc-logs 中 __tag__:__pack_id__ 为 "xxx" 的所有日志
适合希望二次开发的用户。
git clone https://github.com/SuxyEE/aliyun-sls-mcp.git
cd aliyun-sls-mcp
npm install
npm run build
配置 MCP 时使用本地路径:
{
"mcpServers": {
"aliyun-sls": {
"command": "node",
"args": ["e:\\tools\\aliyun-sls-mcp\\dist\\index.js"],
"env": {
"ALIBABA_CLOUD_ACCESS_KEY_ID": "你的AccessKeyId",
"ALIBABA_CLOUD_ACCESS_KEY_SECRET": "你的AccessKeySecret",
"SLS_REGIONS": "cn-hangzhou"
}
}
}
}
开发命令:
npm run dev # 监听文件变化,自动重新编译
npm run build # 构建一次
npm start # 运行(用于验证启动是否正常)
完整接入点列表参见阿里云 SLS 服务接入点文档。
@modelcontextprotocol/sdk@alicloud/sls20201230MIT
阿里云 SLS 日志查询 MCP Server,让 AI 助手(Cursor/Claude)直接用自然语言查询 FC、SAE、ECS、ACK 等服务的日志,告别手动翻控制台
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Aliyun Sls stdio पर लोकल चलता है।
पिछली जाँच 2026-10-28 को हुई। 阿里云 SLS 日志查询 MCP Server,让 AI 助手(Cursor/Claude)直接用自然语言查询 FC、SAE、ECS、ACK 等服务的日志,告别手动翻控制台