使用说明

项目简介

本项目 'alibaba-cloud-ops-mcp-server' 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型（LLM）客户端提供与阿里云运维操作和监控服务集成的能力。通过此 MCP 服务器，LLM 应用可以安全、可扩展地访问和操作阿里云的资源，例如 ECS 云服务器、VPC 虚拟专有网络和云监控服务。

主要功能点

资源操作工具: 提供丰富的工具集，允许 LLM 客户端调用阿里云 ECS 和 VPC 服务的 API，实现云资源的describe、run、start、stop、reboot、delete等运维操作。
监控数据获取: 集成阿里云云监控服务，支持获取 ECS 实例的 CPU、内存、磁盘等关键性能指标数据，帮助 LLM 应用进行智能监控和告警。
动态工具注册: 基于阿里云 OpenAPI 元数据动态生成和注册工具，简化工具扩展和维护。
标准 MCP 协议: 遵循 MCP 协议标准，易于与各种 MCP 客户端集成。
多种传输协议支持: 支持 Stdio 和 SSE 传输协议，满足不同应用场景的需求。

安装步骤

安装 uv: 根据仓库 README.md 的指引，安装 uv 包管理器。

curl -LsSf https://astral.sh/uv/install.sh | sh

配置环境变量: 需要设置阿里云账号的 'ALIBABA_CLOUD_ACCESS_KEY_ID' 和 'ALIBABA_CLOUD_ACCESS_KEY_SECRET' 环境变量，用于访问阿里云 API。

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令才能连接。以下是针对 'alibaba-cloud-ops-mcp-server' 的 MCP 服务器配置信息，请将此配置添加到您的 MCP 客户端配置中：

{
  "mcpServers": {
    "alibaba-cloud-ops-mcp-server": {
      "command": "uvx",
      "args": [
        "alibaba-cloud-ops-mcp-server@latest"
      ],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "Your Access Key ID",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "Your Access Key SECRET"
      }
    }
  }
}

配置参数说明:

'server name': 'alibaba-cloud-ops-mcp-server' - 服务器名称，客户端用于识别和调用。
'command': 'uvx' - 启动服务器的命令，这里使用 'uvx' 运行。
'args': '["alibaba-cloud-ops-mcp-server@latest"]' - 传递给 'uvx' 命令的参数，指定运行 'alibaba-cloud-ops-mcp-server' 包的最新版本。
'env': '{}' - 环境变量配置。
- 'ALIBABA_CLOUD_ACCESS_KEY_ID': 阿里云 Access Key ID，请替换为您的 Access Key ID。
- 'ALIBABA_CLOUD_ACCESS_KEY_SECRET': 阿里云 Access Key Secret，请替换为您的 Access Key Secret。

注意: 请务必将 '"Your Access Key ID"' 和 '"Your Access Key SECRET"' 替换为您实际的阿里云账号 Access Key 信息。请谨慎保管您的 Access Key Secret，避免泄露！

基本使用方法

确保已安装 uv 并配置好阿里云 Access Key 环境变量。
启动 MCP 服务器：客户端根据上述配置信息，通过 'uvx alibaba-cloud-ops-mcp-server@latest' 命令启动服务器。
在 LLM 客户端中，可以调用服务器提供的 Tools，例如 'RunCommand' (在 ECS 实例上运行命令), 'DescribeInstances' (查看 ECS 实例列表), 'GetCpuUsageData' (获取 ECS 实例 CPU 使用率) 等工具，实现对阿里云资源的运维和监控操作。
具体 Tool 的使用方法和参数，请参考代码中的函数签名和描述信息，以及阿里云 API 文档。

关键词