功能概述

该工具主要用于阿里云可观测性数据的采集、处理与分析，支持以下功能：

1. 性能监控：实时采集和分析应用的性能指标
2. 日志管理：收集和查询应用程序的日志信息
3. 追踪系统：实现分布式系统的调用链路追踪
4. 异常检测：自动识别系统中的异常行为
5. 数据可视化：提供丰富的数据展示界面

安装指南

使用 pip 安装

需要 Python 3.10 及以上版本。

直接使用 pip 安装即可，安装命令如下：

pip install mcp-server-aliyun-observability

安装完成后，可以直接运行，运行命令如下：

python -m mcp_server_aliyun_observability --transport sse --access-key-id <your_access_key_id> --access-key-secret <your_access_key_secret>

可通过命令行传递以下参数:

• --transport 指定传输方式，可选值为 sse 或 stdio，默认值为 stdio
• --access-key-id 指定阿里云 AccessKeyId，不指定时会使用环境变量中的ALIBABA_CLOUD_ACCESS_KEY_ID
• --access-key-secret 指定阿里云 AccessKeySecret，不指定时会使用环境变量中的ALIBABA_CLOUD_ACCESS_KEY_SECRET
• --log-level 指定日志级别，可选值为 DEBUG、INFO、WARNING、ERROR，默认值为 INFO
• --transport-port 指定传输端口，默认值为 8000，仅当 --transport 为 sse 时有效

使用 uv 命令启动

可以指定版本号，会自动拉取对应依赖，默认是 studio 方式启动：

uvx --from 'mcp-server-aliyun-observability==0.2.1' mcp-server-aliyun-observability

从源码安装

# 克隆源码
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 --transport sse --access-key-id <your_access_key_id> --access-key-secret <your_access_key_secret>

AI 工具集成

配置说明

以下是一些常用 AI 工具的配置示例：

Cursor 配置示例

# 示例命令行参数
python -m mcp_server_aliyun_observability --transport sse --access-key-id <your_access_key_id> --access-key-secret <your_access_key_secret>

Codelens 配置示例

uvx --from 'mcp-server-aliyun-observability==0.2.1' mcp-server-aliyun-observability

可视化界面截图说明

以下是一些界面截图的说明：

示例截图 1

示例截图 2

注意事项

1. 确保安装 Python 3.10 及以上版本
2. 安装完成后检查环境变量是否配置正确
3. 使用前请确保已获取有效的阿里云访问密钥