alibabacloud-observability-mcp-server

MCP.Pizza Chef: aliyun

Thirty tools reach into Alibaba Cloud's logging and monitoring services to list projects and log stores, run queries, pull metrics, traces and events, follow relationships between services, and compare two time windows to show what changed. Everything is read-only; nothing here can alter or remove your data. It needs a cloud access key pair with the right permissions, and four of the tools, the ones that turn plain questions into queries, are billed per call.

Coding
Data

Use This MCP server To

Ask what went wrong in last night's logs Compare this week's error rate with last week's Pull the key health numbers for one service Trace a slow request through the services it touched List which log collections exist in my account Check what events fired during a specific hour

README

阿里云可观测 MCP Server(Go 版)

中文 English


📌 重要提示

本项目已使用 Go 语言重构。如需使用原 Python 版本,请访问 v1 目录:

  • 📖 v1/README.md - Python 版本文档
  • 📦 Python 版本通过 pip install mcp-server-aliyun-observability 安装

阿里云可观测 MCP Server 的 Go 语言实现,为 AI 模型提供对阿里云日志服务(SLS)和云监控(CMS)的结构化数据访问能力。基于 Model Context Protocol 协议,可与 Cursor、Kiro、Cline、Windsurf 等 AI 工具无缝集成。

特性

  • 支持 stdio、SSE、streamable-http 三种传输模式
  • 模块化工具集架构:PaaS(云监控 2.0)、IaaS(SLS/CMS 直接访问)、Shared
  • 灵活的时间表达式解析:相对时间、绝对时间戳、Grafana 风格、预设关键词
  • 时序数据对比分析:统计计算、趋势分析、差异评分
  • 结构化错误处理:英文错误描述和解决方案建议
  • 稳定性保障:重试(指数退避)、熔断器、优雅关闭
  • 结构化 JSON 日志(slog)
  • 单一二进制文件,零运行时依赖

快速开始

下载与安装

从 Releases 页面下载对应平台的二进制文件:

# Linux amd64
wget https://github.com/aliyun/alibabacloud-observability-mcp-server/releases/latest/download/alibabacloud-observability-mcp-server-linux-amd64.tar.gz
tar -xzf alibabacloud-observability-mcp-server-linux-amd64.tar.gz

# macOS arm64 (M1/M2)
wget https://github.com/aliyun/alibabacloud-observability-mcp-server/releases/latest/download/alibabacloud-observability-mcp-server-darwin-arm64.tar.gz
tar -xzf alibabacloud-observability-mcp-server-darwin-arm64.tar.gz

解压后包含:

  • alibabacloud-observability-mcp-server - 可执行文件
  • config.yaml - 默认配置文件

alibabacloud-observability-mcp-server FAQ

Do I need a key?
Yes, an Alibaba Cloud access key pair, not a simple app key. It carries whatever permissions the account has, so create a limited one rather than using your main credentials.
Does it cost anything to run?
Most tools are free beyond normal cloud charges, but four of them, the ones that translate plain questions into queries, bill per call. You can switch those off in the config file and keep only the free ones.
Can it change or delete anything?
No. Every tool reads: listing, searching, querying and comparing. There is no tool that writes, alters or removes data.
Can I use this to investigate an outage?
Yes, that is its strongest use. It can pull the relevant logs and metrics for a window of time and set two periods side by side to show what changed.
How hard is setup?
This one is for technical hands. You download a program for your platform, edit a configuration file, supply cloud credentials, and either run it directly or leave it listening on a local port.
Is it safe to run as a shared service?
Only behind your own protection. The network mode ships with no access control at all, so anyone who can reach the port can query your data using your credentials.
Which apps does it work with?
Cursor, Kiro, Cline and Windsurf are named, plus any other assistant that supports MCP servers. A rewritten version is now the default; the older one still lives in the repository.