Alibaba Cloud Observability

Accede a productos de observabilidad de Alibaba Cloud como SLS, ARMS y CloudMonitor.

Documentación

Servidor MCP de Observabilidad de Alibaba Cloud (versión Go)

📌 Aviso importante

Este proyecto ha sido reestructurado con el lenguaje Go. Si necesita usar la versión original en Python, visite el directorio v1:

📖 v1/README.md - Documentación de la versión Python

📦 La versión Python se instala mediante pip install mcp-server-aliyun-observability

Implementación en Go del servidor MCP de Observabilidad de Alibaba Cloud, que proporciona a los modelos de IA acceso estructurado a los datos del servicio de registros (SLS) y la monitorización en la nube (CMS) de Alibaba Cloud. Basado en el protocolo Model Context Protocol, se integra sin problemas con herramientas de IA como Cursor, Kiro, Cline, Windsurf, entre otras.

Características

Compatibilidad con tres modos de transporte: stdio, SSE y streamable-http
Arquitectura modular de conjuntos de herramientas: PaaS (Cloud Monitoring 2.0), IaaS (acceso directo a SLS/CMS) y Shared
Análisis flexible de expresiones de tiempo: tiempo relativo, marcas de tiempo absolutas, estilo Grafana y palabras clave predefinidas
Análisis comparativo de datos de series temporales: cálculo estadístico, análisis de tendencias y puntuación de diferencias
Manejo estructurado de errores: descripciones de errores en inglés y sugerencias de soluciones
Garantía de estabilidad: reintentos (retroceso exponencial), interruptor automático y cierre ordenado
Registro estructurado en JSON (slog)
Un único archivo binario, sin dependencias en tiempo de ejecución

Inicio rápido

Descarga e instalación

Descargue el archivo binario correspondiente a su plataforma desde la página de 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

Después de descomprimir, incluye:

alibabacloud-observability-mcp-server - Archivo ejecutable
config.yaml - Archivo de configuración predeterminado

Configuración de credenciales

# 设置阿里云 AccessKey
export ALIBABA_CLOUD_ACCESS_KEY_ID=<your_access_key_id>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<your_access_key_secret>

Cómo obtener AccessKey: Gestión de AccessKey de Alibaba Cloud

Iniciar el servicio

# 以 stdio 模式启动（MCP 客户端直接调用）
./alibabacloud-observability-mcp-server start --stdio

# 以网络模式启动（默认 transport 在 config.yaml 中配置）
./alibabacloud-observability-mcp-server start --config config.yaml

Comandos CLI

# 查看版本信息
./alibabacloud-observability-mcp-server version

# 列出所有已注册工具
./alibabacloud-observability-mcp-server tools

Compilación desde el código fuente

git clone https://github.com/aliyun/alibabacloud-observability-mcp-server.git
cd alibabacloud-observability-mcp-server
make build

Configuración

La configuración adopta una estructura de dos niveles:

config.yaml - Configuración del servidor (modo de transporte, registro, red, etc.)
Archivo .env o variables de entorno - Credenciales y parámetros de ejecución

Para obtener una explicación detallada de los elementos de configuración, consulte los comentarios en config.yaml.

Integración con herramientas de IA

Modo streamable-http (recomendado)

Configure config.yaml (establezca server.transport: streamable-http)
Inicie el servicio: ./bin/alibabacloud-observability-mcp-server start
Configure mcp.json:

{
  "mcpServers": {
    "alibaba_cloud_observability": {
      "url": "http://localhost:8080"
    }
  }
}

Modo stdio

{
  "mcpServers": {
    "alibaba_cloud_observability": {
      "command": "./bin/alibabacloud-observability-mcp-server",
      "args": ["start", "--stdio"],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "<your_access_key_id>",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "<your_access_key_secret>"
      }
    }
  }
}

Conjunto de herramientas

Ver la lista completa de herramientas

Ejecute el siguiente comando para ver todas las herramientas registradas actualmente:

./bin/alibabacloud-observability-mcp-server tools

Descripción de las funciones de pago

Las siguientes herramientas de IA inteligente generan cargos de STAROps en cada invocación:

Herramienta	Función
`sls_text_to_sql`	Conversión de lenguaje natural a SQL
`sls_text_to_spl`	Conversión de lenguaje natural a SPL
`sls_sop`	Asistente de operaciones inteligentes de SLS
`cms_natural_language_query`	Consulta de datos en lenguaje natural

Consulte los detalles de facturación en Descripción de facturación de STAROps. Si no necesita capacidades de IA, puede habilitar solo las herramientas gratuitas en enabled_tools de config.yaml.

Requisitos de permisos

Servicio	Documentación de permisos	Herramientas aplicables
Servicio de registros (SLS)	Permisos de SLS	`sls_*`
Monitorización en tiempo real de aplicaciones (ARMS)	Permisos de ARMS	`umodel_*`
Monitorización en la nube (CMS)	Permisos de CMS	`cms_*`

Permisos especiales: El uso de herramientas de IA inteligente (como sls_text_to_sql, cms_natural_language_query) requiere otorgar los permisos cms:CreateChat, cms:CreateThread de CMS.

Expresiones de tiempo

Todas las herramientas de consulta de datos admiten formatos flexibles de rango de tiempo:

Formato	Ejemplo
Predefinido relativo	`last_5m`, `last_1h`, `last_1d`
Tiempo relativo	`now()-1h`, `now-30m`
Estilo Grafana	`now-15m~now-5m`, `now/d`, `now-1d/d`
Marca de tiempo absoluta	`1718451045` (segundos), `1718451045000` (milisegundos)
Cadena de fecha y hora	`2024-01-01 00:00:00`, `2024-01-01T00:00:00Z`

Estructura del proyecto

├── cmd/server/          # CLI 入口
├── pkg/
│   ├── client/          # SLS/CMS 客户端
│   ├── config/          # 配置管理
│   ├── server/          # MCP Server 核心
│   └── toolkit/         # 工具集（PaaS/IaaS/Shared）
└── v1/                  # Python 版本

Recomendaciones de seguridad

El servicio no almacena AccessKey, solo se utiliza para llamadas a la API en tiempo de ejecución
En los modos SSE/HTTP, debe implementar su propio control de acceso
Se recomienda implementar en una red interna o VPC, evitando la exposición a Internet
Se recomienda implementar con Function Compute (FC), con acceso solo dentro de la VPC

Implementación automatizada con Skill

Este proyecto proporciona un Skill de Agente de IA que admite la implementación, el inicio y la actualización mediante instrucciones en lenguaje natural.

Instalación del Skill

Método 1: npx skills add (recomendado)

Instalador de skills universal mantenido por Vercel Labs, compatible con más de 69 agentes de codificación:

# 全局安装（所有项目可用）
npx skills add aliyun/alibabacloud-observability-mcp-server

# 项目级安装（仅当前项目可用）
npx skills add aliyun/alibabacloud-observability-mcp-server --local

Método 2: curl (sin necesidad de Node.js)

# 下载并安装 skill 到 ~/.claude/skills/
curl -fsSL https://raw.githubusercontent.com/aliyun/alibabacloud-observability-mcp-server/master/skills/deploy-observability/SKILL.md -o ~/.claude/skills/deploy-observability/SKILL.md

Método 3: Copiar desde el repositorio del proyecto

Si ya ha clonado este proyecto:

# 全局安装
cp skills/deploy-observability/SKILL.md ~/.claude/skills/deploy-observability/

# 或项目级安装（在项目根目录下）
cp skills/deploy-observability/SKILL.md .claude/skills/deploy-observability/

Uso del Skill

Después de instalar el skill, copie el siguiente contenido en un Agente de IA compatible con Skill (como Claude Code):

Primera implementación:

请使用 deploy-observability skill 帮我完成以下操作：
1. 克隆项目到 ~/alibabacloud-observability-mcp-server
2. 下载依赖并构建
3. 复制 .env.example 为 .env，并提示我填写阿里云 AccessKey
4. 让我选择启动模式（stdio / sse / streamable-http）
5. 生成 JSON 配置，供我粘贴到 AI Agent 中使用

Actualización del proyecto:

请使用 deploy-observability skill 帮我更新项目：
1. 拉取最新代码
2. 检测是否有依赖、配置或环境变量变更
3. 对比工具列表变化，告诉我新增/删除了哪些工具
4. 重新构建并重启服务

Para obtener documentación de uso detallada, consulte skills/deploy-observability/SKILL.md.

Licencia

Este proyecto sigue el mismo acuerdo de licencia que la versión original en Python.