{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_jv7az34rv8wm","handle":"mcp-server-aliyun-observability","url":"https://wellknown.network/agents/mcp-server-aliyun-observability","links":{"self":"https://wellknown.network/agents/mcp-server-aliyun-observability/record.json","html":"https://wellknown.network/agents/mcp-server-aliyun-observability","markdown":"https://wellknown.network/agents/mcp-server-aliyun-observability/record.md","api":"https://wellknown.network/api/v1/agents/mcp-server-aliyun-observability","status":"https://wellknown.network/api/v1/agents/mcp-server-aliyun-observability/status","claim":"https://wellknown.network/agents/mcp-server-aliyun-observability/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-server-aliyun-observability/claim.json","badge":"https://wellknown.network/agents/mcp-server-aliyun-observability/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-server-aliyun-observability/history","tools":"https://wellknown.network/api/v1/agents/mcp-server-aliyun-observability/tools"},"ard":{"identifier":"urn:air::server:mcp-server-aliyun-observability","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-server-aliyun-observability","summary":"aliyun observability mcp server","description":"> 分支变动说明：`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 版本维护和演进，感谢理解与支持。\n\n## 什么是 Observable MCP Server\n\nObservable MCP Server 是阿里云可观测官方推出的一个 MCP 服务，旨在为用户提供一整套的可观测 AI 交互能力，支持自然语言形式的多模态数据的访问和分析。可以与 Cursor、Cline、Windsurf 以及各类 Agent 框架无缝集成，使得企业人员可以更高效率和可靠地使用可观测数据。\n\n## MCP 是如何工作的\n\nMCP（Model Context Protocol）为 AI 模型和开发环境之间建立统一的上下文交互标准，使模型可以在安全受控的前提下访问实时的领域知识。Observable MCP Server 通过这一协议，将自然语言需求映射为标准化工具调用，再透明地调度底层的日志、链路、指标等可观测产品接口，让智能体无需额外适配即可获取结构化结果。\n\nObservable MCP Server 现已支持日志服务 SLS、应用实时监控服务 ARMS、云监控 CloudMonitor、Prometheus 监控等多款产品的查询与分析能力，并持续扩展更多可观测服务。\n\n## Observable MCP Server 的优势\n\n1. 多源数据协同：一次接入即可同时查询 SLS、ARMS、CloudMonitor、Prometheus 等多款可观测产品的数据，统一呈现日志、指标与链路视角。\n2. 自然语言驱动：无需手写查询语句，支持通过自然语言直接检索日志、链路、指标等信息，并返回结构化答案。\n3. 企业级安全：基于阿里云 AccessKey 认证机制，服务端不额外采集数据，对每个工具的输入输出进行严格校验，保障数据安全可控。\n\n## 阿里云可观测MCP服务\n<p align=\"center\">\n  <a href=\"./README.md\"><img alt=\"中文自述文件\" src=\"https://img.shields.io/badge/简体中文-d9d9d9\"\"></a>\n  <a href=\"./README_EN.md\"><img alt=\"英文自述文件\" src=\"https://img.shields.io/badge/English-d9d9d9\")\n</p>\n\n### 简介\n\n阿里云可观测 MCP服务，提供了一系列访问阿里云可观测各产品的工具能力，覆盖产品包含阿里云日志服务SLS、阿里云应用实时监控服务ARMS、阿里云云监控等，任意支持 MCP 协议的智能体助手都可快速接入。\n\n### 工具架构\n项目采用模块化架构，提供四个主要工具集：\n\n- **PaaS工具集**（可观测2.0，推荐）：包含 umodel 系列工具，提供统一数据模型的现代化可观测性能力\n  - `entity`: 实体发现和管理 (3个工具)\n  - `dataset`: 数据集和元数据管理 (3个工具)\n  - `data`: 各类数据查询，支持metrics、logs、events、traces、profiles (8个工具)\n- **IaaS工具集**（V1兼容）：传统SLS、CMS原生API工具，保持向后兼容 (7个工具)\n- **Shared工具集**：跨服务共享工具，如workspace和domain管理 (3个工具)\n\n📚 **详细的工具组合推荐请参考**：[最佳工具组合推荐文档](./docs/best_practices_toolkit_combinations.md)\n\n### 版本记录\n可以查看 [CHANGELOG.md](./CHANGELOG.md)\n\n### 常见问题\n可以查看 [FAQ.md](./FAQ.md)\n\n### 工具列表\n\n#### PaaS工具集（可观测2.0）\n\n##### 实体管理工具 (entity)\n| 工具名称 | 用途 | 关键参数 | 最佳实践 |  \n|---------|------|---------|---------|  \n| `umodel_get_entities` | 获取指定实体集的实体列表 | `workspace`：工作空间名称（必需）<br>`domain`：实体域（必需）<br>`entity_set_name`：实体类型（必需）<br>`regionId`：阿里云区域ID（必需…","publisher":null,"homepage":null,"repository":null,"version":"1.0.8","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-server-aliyun-observability","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.monitoring","name":"Monitoring & Observability","confidence":1,"provenance":"derived"}],"categories":["dev"],"language":"zh"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-server-aliyun-observability","registry":"pypi","observedAt":"2026-11-03T15:23:13.136Z","publishedAt":"2026-03-17T02:46:39.078652Z","latestVersion":"1.0.8"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-server-aliyun-observability","url":"https://pypi.org/project/mcp-server-aliyun-observability/","firstSeenAt":"2026-09-10T03:19:54.090Z","fetchedAt":"2026-11-03T15:21:49.002Z","normalizedAt":"2026-11-03T15:21:49.002Z"}]},"firstSeenAt":"2026-09-10T03:19:54.090Z","updatedAt":"2026-11-03T15:23:13.136Z"}