aliyun/alibabacloud-observability-mcp-server

> 📌 重要提示
> 本项目已使用 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 页面下载对应平台的二进制文件：
bash
# 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 - 默认配置文件
### 配置凭证
bash
# 设置阿里云 AccessKey
export ALIBABA_CLOUD_ACCESS_KEY_ID=
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=
> AccessKey 获取方式：阿里云 AccessKey 管理
### 启动服务
bash
# 以 stdio 模式启动（MCP 客户端直接调用）
./alibabacloud-observability-mcp-server start --stdio
# 以网络模式启动（默认 transport 在 config.yaml 中配置）
./alibabacloud-observability-mcp-server start --config config.yaml
### CLI 命令
bash
# 查看版本信息
./alibabacloud-observability-mcp-server version
# 列出所有已注册工具
./alibabacloud-observability-mcp-server tools
## 从源码构建
bash
git clone https://github.com/aliyun/alibabacloud-observability-mcp-server.git
cd alibabacloud-observability-mcp-server
make build
## 配置
配置采用两层结构：
1. config.yaml - 服务器配置（传输模式、日志、网络等）
2. .env 文件或环境变量 - 凭证和运行时参数
详细的配置项说明请参考 config.yaml 中的注释。
## AI 工具集成
### streamable-http 模式（推荐）
1. 配置 config.yaml（设置 server.transport: streamable-http）
2. 启动服务：./bin/alibabacloud-observability-mcp-server start
3. 配置 mcp.json：
json
"mcpServers": {
"alibaba_cloud_observability": {
"url": "http://localhost:8080"
### stdio 模式
json
"mcpServers": {
"alibaba_cloud_observability": {
"command": "./bin/alibabacloud-observability-mcp-server",
"args": ["start", "--stdio"],
"env": {
"ALIBABA_CLOUD_ACCESS_KEY_ID": " ",
"ALIBABA_CLOUD_ACCESS_KEY_SECRET": " "
## 工具集
### 查看完整工具列表
运行以下命令查看当前注册的所有工具：
bash
./bin/alibabacloud-observability-mcp-server tools
### 付费功能说明
以下 AI 智能工具每次调用会产生 STAROps 费用：
| 工具 | 功能 |
| sls_text_to_sql | 自然语言转 SQL |
| sls_text_to_spl | 自然语言转 SPL |
| sls_sop | SLS 智能运维助手 |
| cms_natural_language_query | 自然语言数据查询 |
计费详情查看 STAROps 计费说明。如不需要 AI 能力，可在 config.yaml 的 enabled_tools 中仅启用免费工具。
### 权限要求
| 服务 | 权限文档 | 适用工具 |
| 日志服务 (SLS) | SLS 权限 | sls_ |
| 应用实时监控 (ARMS) | ARMS 权限 | umodel_ |
| 云监控 (CMS) | CMS 权限 | cms_ |
特殊权限：使用 AI 智能工具（如 sls_text_to_sql、cms_natural_language_query）需要授予 CMS 的 cms:CreateChat、cms:CreateThread 权限。
### 时间表达式
所有数据查询工具支持灵活的时间范围格式：
| 格式 | 示例 |
| 相对预设 | last_5m、last_1h、last_1d |
| 相对时间 | now()-1h、now-30m |