Aliyun MCP Server

Aliyun MCP Server

site icon
2025.03.26 2
JavaScript云服务管理日志查询开发效率数据库
Aliyun MCP Server 是一个通过 Claude 与阿里云服务交互的工具集。它目前主要提供查询阿里云简单日志服务(SLS)的功能,并计划未来扩展支持管理 ECS 实例和部署无服务器函数。
View on GitHub

Overview

基本能力

产品定位

Aliyun MCP Server 是一个中间件服务,旨在通过 Claude 平台提供对阿里云服务的便捷访问和控制。

核心功能

  • 查询 SLS(Simple Log Service)日志
  • (未来)管理 ECS 实例
  • (未来)部署无服务器函数

适用场景

  • 开发人员需要快速查询和分析云服务日志
  • 运维人员需要监控云服务状态
  • 团队需要通过 Claude 平台集中管理云资源

工具列表

  1. querySLSLogs
  2. 功能:查询阿里云 SLS 日志
  3. 参数:
    • project(必需):SLS 项目名称
    • logstore(必需):SLS 日志存储名称
    • query(必需):SLS 查询语句
    • from(可选):开始时间(毫秒,默认1小时前)
    • to(可选):结束时间(毫秒,默认现在)
    • limit(可选):返回日志最大数量(默认100,最大1000)
    • offset(可选):分页偏移量(默认0)
    • reverse(可选):是否反向返回结果(默认false)

常见问题解答

  • 如何配置阿里云访问凭证? 需要在环境变量中设置 ALIYUN_ACCESS_KEY_IDALIYUN_ACCESS_KEY_SECRET
  • 如何指定 SLS 终端节点? 通过 SLS_ENDPOINT 环境变量配置

使用教程

使用依赖

  1. 确保已安装 Node.js 环境
  2. 确保拥有有效的阿里云访问凭证

安装教程

npm install
npm run build

配置方式

  1. 对于 Claude Desktop,编辑 claude_desktop_config.json:
{
  "mcpServers": {
    "aliyun": {
      "command": "node",
      "args": ["/path/to/aliyun-mcp-server/build/index.js"],
      "env": {
        "ALIYUN_ACCESS_KEY_ID": "your-access-key-id",
        "ALIYUN_ACCESS_KEY_SECRET": "your-access-key-secret",
        "SLS_ENDPOINT": "cn-hangzhou.log.aliyuncs.com"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
  1. 对于 Cline,编辑 VSCode 设置中的 cline_mcp_settings.json:
{
  "mcpServers": {
    "aliyun": {
      "command": "node",
      "args": ["/path/to/aliyun-mcp-server/build/index.js"],
      "env": {
        "ALIYUN_ACCESS_KEY_ID": "your-access-key-id",
        "ALIYUN_ACCESS_KEY_SECRET": "your-access-key-secret",
        "SLS_ENDPOINT": "cn-hangzhou.log.aliyuncs.com"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

调试方式

  1. 通过 Claude 发送查询命令:
Query SLS logs from project "my-project" and logstore "my-logstore" with the query "error" for the last hour.
  1. 检查返回的日志数据是否符合预期

许可证

None