腾讯云 CLS MCP Server

腾讯云日志服务（CLS）MCP Server，基于 Model Context Protocol 实现，让大语言模型能够直接访问腾讯云 CLS 的日志检索、指标查询、告警管理等能力，无需编写代码即可完成日志分析。

📖 腾讯云官方文档 | 🚀 SSE 托管服务 - MCP 市场（免费使用）

核心能力

日志检索

指标查询

告警管理

辅助工具

使用场景

• 自然语言日志查询 — 使用自然语言查询日志，无需掌握复杂的查询语法，大幅降低日志分析门槛。
• 智能运维排障 — 整合至运维排障流程中，智能分析系统异常，快速定位问题根因。
• 自动生成查询语句 — 通过 TextToSearchLogQuery 将自然语言自动转换为 CLS 查询语句，实现更精准高效的日志检索。
• 业务指标监控 — 查询并监控指标主题的实时值与历史趋势，及时掌握系统运行状态。
• 告警管理与分析 — 查看告警策略、查询告警触发/恢复历史记录、分析告警执行详情，快速了解告警状态。

配置参数说明

快速开始

方式一：腾讯云 SSE 托管服务（无需本地环境）

使用腾讯云 MCP 市场提供的 SSE 托管服务，无需安装 Node.js 或任何本地依赖。前往 MCP 市场 获取 SSE 端点地址，然后配置 MCP 客户端：

{
  "mcpServers": {
    "cls-mcp-server": {
      "name": "cls-mcp-server",
      "type": "sse",
      "isActive": true,
      "baseUrl": "<从MCP市场获取的SSE端点地址>"
    }
  }
}

方式二：NPX 启动（推荐的本地部署方式）

在 MCP 客户端的 mcpServers 配置中添加：

前置条件：安装 Node.js（推荐 LTS 版本），准备腾讯云 SecretId 和 SecretKey。

{
  "mcpServers": {
    "cls-mcp-server": {
      "isActive": true,
      "name": "cls-mcp-server",
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cls-mcp-server@latest"
      ],
      "env": {
        "TRANSPORT": "stdio",
        "TENCENTCLOUD_SECRET_ID": "<YOUR_SECRET_ID>",
        "TENCENTCLOUD_SECRET_KEY": "<YOUR_SECRET_KEY>",
        "TZ": "Asia/Shanghai"
      }
    }
  }
}

方式三：自建 SSE 模式

前置条件：安装 Node.js（推荐 LTS 版本），准备腾讯云 SecretId 和 SecretKey。

1. 在当前目录创建 .env 文件：

TRANSPORT=sse
TENCENTCLOUD_SECRET_ID=<YOUR_SECRET_ID>
TENCENTCLOUD_SECRET_KEY=<YOUR_SECRET_KEY>
PORT=3000
TZ=Asia/Shanghai

2. 启动 SSE 服务：

npx -y cls-mcp-server@latest

3. 在 MCP 客户端中配置：

{
  "mcpServers": {
    "cls-mcp-server": {
      "name": "cls-mcp-server",
      "type": "sse",
      "isActive": true,
      "baseUrl": "http://localhost:3000/sse"
    }
  }
}

方式四：源码安装

前置条件：安装 Node.js（推荐 LTS 版本），准备腾讯云 SecretId 和 SecretKey。

1. 克隆仓库并构建：

git clone <repository-url>
cd cls-mcp-server
npm install
npm run build

2. Stdio 模式 — 在 MCP 客户端的 mcpServers 配置中添加：

{
  "mcpServers": {
    "cls-mcp-server": {
      "isActive": true,
      "name": "cls-mcp-server",
      "type": "stdio",
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/cls-mcp-server/dist/index.js"
      ],
      "env": {
        "TRANSPORT": "stdio",
        "TENCENTCLOUD_SECRET_ID": "<YOUR_SECRET_ID>",
        "TENCENTCLOUD_SECRET_KEY": "<YOUR_SECRET_KEY>",
        "TZ": "Asia/Shanghai"
      }
    }
  }
}

3. SSE 模式 — 在项目根目录创建 .env 文件：

TRANSPORT=sse
TENCENTCLOUD_SECRET_ID=<YOUR_SECRET_ID>
TENCENTCLOUD_SECRET_KEY=<YOUR_SECRET_KEY>
PORT=3000
TZ=Asia/Shanghai

启动 SSE 服务：

npm run start:sse

然后在 MCP 客户端中配置：

{
  "mcpServers": {
    "cls-mcp-server": {
      "name": "cls-mcp-server",
      "type": "sse",
      "isActive": true,
      "baseUrl": "http://localhost:3000/sse"
    }
  }
}

License

Apache License 2.0