MCP（Model Context Protocol）是大模型和开发环境之间建立统一上下文交互标准化接口的协议，使模型可以在安全受控的前提下访问实时的领域知识。Observable MCP Server 是云监控2.0的 MCP 服务，旨在为用户提供一整套的可观测 AI 交互能力，支持自然语言形式的多模态数据的访问和分析。可以与 Cursor、Cline、Windsurf 以及各类 Agent 框架无缝集成，使得企业人员可以更高效率和可靠地使用可观测数据。
Observable MCP Server 的优势
多源数据协同：一次接入即可同时查询日志服务 SLS、应用实时监控服务 ARMS、云监控 CloudMonitor、Prometheus 监控等多款可观测产品的数据，统一呈现日志、指标与链路视角。
自然语言驱动：无需手写查询语句，支持通过自然语言直接检索日志、链路、指标等信息，并返回结构化答案。
企业级安全：基于阿里云 AccessKey 认证机制，服务端不额外采集数据，对每个工具的输入输出进行严格校验，保障数据安全可控。
如何接入
步骤一：权限配置
服务运行需要有效的阿里云 AccessKey ID 和 AccessKey Secret，可通过 创建AccessKey获取。
若使用RAM用户则需要注意：
与 AccessKey 关联的 RAM 用户或角色必须被授予访问相关云服务所需的权限。
请遵循"最小权限原则"：仅授予计划使用的 MCP 工具所需最小权限集，以降低安全风险。
Observable MCP Server 在运行时会使用您提供的 AccessKey 调用阿里云 OpenAPI，但不会以任何形式存储 AccessKey，也不会将其用于设计功能之外的任何其他用途。
步骤二：安装 MCP 服务
此处提供三种安装方式，请按需要选择。强烈建议将 MCP Server 部署在内部网络或受信环境中，例如私有 VPC (Virtual Private Cloud) 内，避免直接暴露于公共互联网。推荐使用阿里云函数计算 (FC)部署，并配置其网络设置为仅 VPC 内访问，以实现网络层面的隔离和安全。
使用 pip 安装
⚠️ 需要 Python 3.10 及以上版本。
直接使用 pip 安装即可，安装命令如下：
# 安装最新版本（包含所有功能和依赖） ，若指定版本安装，请使用1.0.0+以上版本，才具备云监控 2.0 的功能 pip install mcp-server-aliyun-observability安装之后，直接运行即可，可在如下命令中选择需要的运行命令执行：
# 默认使用streamableHttp方式启动 python -m mcp_server_aliyun_observability # 指定访问密钥启动 python -m mcp_server_aliyun_observability --access-key-id <your_access_key_id> --access-key-secret <your_access_key_secret> # 使用SSE方式启动（用于远程访问） python -m mcp_server_aliyun_observability --transport sse --transport-port 8000
使用 uvx 安装运行
在如下命令中选择需要的运行命令执行：
# 使用 uvx 直接运行最新版本
uvx mcp-server-aliyun-observability
# 指定版本运行
uvx --from 'mcp-server-aliyun-observability==1.0.0' mcp-server-aliyun-observability克隆源码安装
# clone 源码
git clone git@github.com:aliyun/alibabacloud-observability-mcp-server.git
# 进入源码目录
cd alibabacloud-observability-mcp-server
# 安装
pip install -e .
# 运行
python -m mcp_server_aliyun_observability运行时可通过命令行传递指定参数:
运行参数 | 含义 | 选项 |
| 指定传输方式。 | 可选值为
|
| 指定阿里云 AccessKeyId，不指定时会使用环境变量中的ALIBABA_CLOUD_ACCESS_KEY_ID。 | 重要 切勿在没有任何身份验证或访问控制机制的情况下，将配置了您 AccessKey 的 MCP Server SSE 端点暴露在公共互联网上，这会带来极高的安全风险。 初始化时不传入 AccessKey 和 AccessKey Secret 时，会使用默认凭据链：
|
| 指定阿里云 AccessKeySecret，不指定时会使用环境变量中的ALIBABA_CLOUD_ACCESS_KEY_SECRET。 | |
| 指定要启用的工具包，用逗号分隔。 | 如 |
| 指定日志级别。 | 可选值为 |
| 指定传输端口。 | 默认值为 |
使用 MCP 服务示例
查询拥有的Projects
运行 MCP 服务后使用自然语言向大模型提问，进行Projects列表的查询。
通过调用 MCP Server 提供的工具sls_list_projects进行数据查询，实现多源数据协同。
工作空间实体查询
运行 MCP 服务后使用自然语言向大模型提问，进行任意workspace下实体列表的查询，通过调用 MCP Server 提供的工具list_workspace，list_domains，umodel_search_entity_set等进行数据查询。
查询实体相关数据
运行 MCP 服务后使用自然语言向大模型提问，进行任意实体中相关数据的查询。
通过调用 MCP Server 提供的工具umodel_list_data_set，umodel_get_metrics等进行数据查询。
相关参考
支持的工具列表参考
MCP 工具列表更新较为频繁，具体支持工具列表以最新 SDK 为准。