项目简介

阿里云可观测MCP服务是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大语言模型 (LLM) 应用提供访问阿里云可观测性产品的统一接口。该服务目前主要集成了阿里云日志服务 (SLS) 和应用实时监控服务 (ARMS)，允许LLM客户端通过标准化的MCP协议，安全、便捷地获取云监控数据和调用相关工具能力。

主要功能点：

资源访问: 提供工具访问和查询阿里云日志服务SLS和应用实时监控服务ARMS的数据资源。
工具集成: 内置丰富的工具集，例如：
- SLS工具: 日志库列表查询、日志库结构描述、日志查询执行、自然语言转SQL查询、SQL查询诊断等。
- ARMS工具: 应用搜索、调用链查询语句生成等。
- 通用工具: 获取当前时间等。
多协议支持: 支持 SSE (Server-Sent Events) 和 Stdio 两种传输协议，方便集成到不同的LLM应用环境中。
安全可靠: 支持阿里云AccessKey和默认凭据链进行身份验证，同时建议部署在VPC等安全网络环境中，保障云资源访问安全。

安装步骤

环境准备: 确保已安装 Python 3.10 或更高版本。

安装软件包: 使用 pip 安装 'mcp-server-aliyun-observability' 包：

pip install mcp-server-aliyun-observability

服务器配置

MCP 服务器需要配置启动命令及其参数，以下是基于不同启动方式的配置信息（JSON 格式），请根据您的MCP客户端进行配置。

1. SSE 启动方式 (推荐用于集成 Cursor, Cline 等客户端):

{
  "mcpServers": {
    "alibaba_cloud_observability": {
      "url": "http://localhost:8000/sse"
    }
  }
}

参数说明:

'url': MCP 服务器的 SSE 接口 URL，默认为 'http://localhost:8000/sse'。端口 '8000' 为默认端口，可通过 '--transport-port' 参数修改。

2. Stdio 启动方式 (适用于标准输入输出的客户端):

{
  "mcpServers": {
    "alibaba_cloud_observability": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_aliyun_observability"
      ],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "<your_access_key_id>",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "<your_access_key_secret>"
      }
    }
  }
}

参数说明:

'command': 启动 MCP 服务器的命令，这里使用 'python'。
'args': 传递给 'python' 命令的参数，'-m mcp_server_aliyun_observability' 表示以模块方式运行 MCP 服务器。
'env': 环境变量配置，用于传递阿里云 AccessKeyId 和 AccessKeySecret。请将 '<your_access_key_id>' 和 '<your_access_key_secret>' 替换为您的实际 AccessKey 信息。您也可以选择在启动服务器时通过命令行参数 '--access-key-id' 和 '--access-key-secret' 传入。

3. Stdio 启动方式 (uv 命令启动):

{
  "mcpServers": {
    "alibaba_cloud_observability": {
      "command": "uv",
      "args": [
        "run",
        "mcp-server-aliyun-observability"
      ],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "<your_access_key_id>",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "<your_access_key_secret>"
      }
    }
  }
}

参数说明:

'command': 启动 MCP 服务器的命令，这里使用 'uv' (需要已安装 uv)。
'args': 传递给 'uv run' 命令的参数，'mcp-server-aliyun-observability' 表示运行 MCP 服务器模块。
'env': 环境变量配置，与上方 Stdio 启动方式相同。

基本使用方法

启动 MCP 服务器: 根据您选择的传输协议 (SSE 或 Stdio) 和配置方式，运行相应的启动命令。例如，使用 SSE 协议，并使用命令行参数指定 AccessKey，可以运行：

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

配置 MCP 客户端: 在您的 LLM 客户端 (如 Cursor, Cline, Cherry Studio, ChatWise 等) 中，配置 MCP 服务器连接信息，通常需要提供服务器地址 (URL for SSE, command and args for Stdio) 和认证信息 (AccessKey 或环境变量)。
通过 LLM 客户端调用工具: 在 LLM 应用中，即可通过自然语言指令或工具调用方式，使用 MCP 服务器提供的各项工具，例如查询日志、监控数据等。

注意:

首次使用前，请务必参考权限要求章节配置 RAM 授权，确保您的 AccessKey 拥有访问阿里云可观测性服务的必要权限。
出于安全考虑，强烈建议将 MCP Server 部署在内部网络或受信环境中，避免直接暴露于公共互联网。

关键词

项目简介

安装步骤

服务器配置

基本使用方法

信息