mcp-server-aliyun-observability

> 分支变动说明：`master` 已使用 `1.x.x` ；原 `master` 全量历史和代码已迁移到 `0.3.x` 分支，后续如需沿用旧版本，请在 `0.3.x` 上继续迭代。1.x 版本基于可观测 2.0 做了较大功能升级，工具形态与 0.3.x 有明显差异。详情见文末《0.3.x 与 1.x.x 工具差异对照》。后续我们将持续基于 1.x.x 版本维护和演进，感谢理解与支持。 ## 什么是 Observable MCP Server Observable MCP Server 是阿里云可观测官方推出的一个 MCP 服务，旨在为用户提供一整套的可观测 AI 交互能力，支持自然语言形式的多模态数据的访问和分析。可以与 Cursor、Cline、Windsurf 以及各类 Agent 框架无缝集成，使得企业人员可以更高效率和可靠地使用可观测数据。 ## MCP 是如何工作的 MCP（Model Context Protocol）为 AI 模型和开发环境之间建立统一的上下文交互标准，使模型可以在安全受控的前提下访问实时的领域知识。Observable MCP Server 通过这一协议，将自然语言需求映射为标准化工具调用，再透明地调度底层的日志、链路、指标等可观测产品接口，让智能体无需额外适配即可获取结构化结果。 Observable MCP Server 现已支持日志服务 SLS、应用实时监控服务 ARMS、云监控 CloudMonitor、Prometheus 监控等多款产品的查询与分析能力，并持续扩展更多可观测服务。 ## Observable MCP Server 的优势 1. 多源数据协同：一次接入即可同时查询 SLS、ARMS、CloudMonitor、Prometheus 等多款可观测产品的数据，统一呈现日志、指标与链路视角。 2. 自然语言驱动：无需手写查询语句，支持通过自然语言直接检索日志、链路、指标等信息，并返回结构化答案。 3. 企业级安全：基于阿里云 AccessKey 认证机制，服务端不额外采集数据，对每个工具的输入输出进行严格校验，保障数据安全可控。 ## 阿里云可观测MCP服务 <p align="center"> <a href="./README.md"><img alt="中文自述文件" src="https://img.shields.io/badge/简体中文-d9d9d9""></a> <a href="./README_EN.md"><img alt="英文自述文件" src="https://img.shields.io/badge/English-d9d9d9") </p> ### 简介 阿里云可观测 MCP服务，提供了一系列访问阿里云可观测各产品的工具能力，覆盖产品包含阿里云日志服务SLS、阿里云应用实时监控服务ARMS、阿里云云监控等，任意支持 MCP 协议的智能体助手都可快速接入。 ### 工具架构 项目采用模块化架构，提供四个主要工具集： - **PaaS工具集**（可观测2.0，推荐）：包含 umodel 系列工具，提供统一数据模型的现代化可观测性能力 - `entity`: 实体发现和管理 (3个工具) - `dataset`: 数据集和元数据管理 (3个工具) - `data`: 各类数据查询，支持metrics、logs、events、traces、profiles (8个工具) - **IaaS工具集**（V1兼容）：传统SLS、CMS原生API工具，保持向后兼容 (7个工具) - **Shared工具集**：跨服务共享工具，如workspace和domain管理 (3个工具) 📚 **详细的工具组合推荐请参考**：[最佳工具组合推荐文档](./docs/best_practices_toolkit_combinations.md) ### 版本记录 可以查看 [CHANGELOG.md](./CHANGELOG.md) ### 常见问题 可以查看 [FAQ.md](./FAQ.md) ### 工具列表 #### PaaS工具集（可观测2.0） ##### 实体管理工具 (entity) | 工具名称 | 用途 | 关键参数 | 最佳实践 | |---------|------|---------|---------| | `umodel_get_entities` | 获取指定实体集的实体列表 | `workspace`：工作空间名称（必需）<br>`domain`：实体域（必需）<br>`entity_set_name`：实体类型（必需）<br>`regionId`：阿里云区域ID（必需…