F
licenseB
qualityC
maintenanceA Claude integration tool that enables users to query and analyze Aliyun (Alibaba Cloud) Simple Log Service logs through natural language commands.
1
26
2
CLS MCP Server
CLS MCP 서버
텐센트 클라우드 로그 서비스(Cloud Log Service) MCP 서버 —— 관측성 관점에서 AI 어시스턴트에게 전방위적인 로그 서비스 기능을 제공합니다.
기능 특징
로그 조회 및 분석: CQL 검색 + SQL 파이프라인 분석, 컨텍스트 보기, 히스토그램, 로그 카운트
메트릭 쿼리: PromQL 호환 단일 시점/시간 범위 메트릭 쿼리
경보 관리: 경보 전략/알림 채널/경보 기록 조회 및 관리
리소스 관리: 로그 세트, 로그 주제, 인덱스, 머신 그룹, 대시보드의 CRUD(생성, 조회, 수정, 삭제)
데이터 가공 & 정기 SQL: 데이터 가공 작업 및 정기 SQL 작업 관리
3단계 권한 제어: READ(기본값) / WRITE / DANGER 등급별 보호
총 37개의 도구가 포함되어 있으며, CLS 로그 서비스의 전체 기능을 포괄합니다.
Related MCP server: Alibaba Cloud Observability MCP Server
도구 목록
로그 검색 (5개)
도구 이름 | 기능 설명 | 권한 |
| CLS 로그 검색 및 분석, CQL 구문 검색 및 SQL 파이프라인 분석 지원 | 읽기 전용 |
| 로그 컨텍스트 가져오기, 대상 로그 전후 기록 확인 | 읽기 전용 |
| 로그 수 히스토그램 가져오기, 시간 경과에 따른 로그량 분포 관찰 | 읽기 전용 |
| 로그 수 빠르게 가져오기, search_log보다 빠름 | 읽기 전용 |
| CLS 로그 검색 구문 참조 및 일반적인 쿼리 템플릿 가져오기 | 읽기 전용 |
메트릭 쿼리 (3개)
도구 이름 | 기능 설명 | 권한 |
| 메트릭 데이터 쿼리(단일 시점), PromQL 구문 지원 | 읽기 전용 |
| 메트릭 데이터 쿼리(시간 범위), 메트릭 변화 추세 확인 | 읽기 전용 |
| 메트릭 주제 하의 모든 사용 가능한 메트릭 이름 나열 | 읽기 전용 |
경보 관리 (8개)
도구 이름 | 기능 설명 | 권한 |
| 경보 전략 목록 조회, 페이징 및 필터링 지원 | 읽기 전용 |
| 경보 전략 ID를 기반으로 전체 경보 구성 가져오기 | 읽기 전용 |
| 경보 알림 채널 목록 조회(이메일, SMS, 콜백 등) | 읽기 전용 |
| 경보 이력 트리거 기록 조회 | 읽기 전용 |
| 경보 상세 URL을 통해 경보 상세 정보 가져오기 | 읽기 전용 |
| 경보 전략 생성 | ⚠️ 쓰기 |
| 경보 전략 구성 수정 | ⚠️ 쓰기 |
| 경보 전략 삭제(복구 불가) | 🚨 위험 |
리소스 관리 (14개)
도구 이름 | 기능 설명 | 권한 |
| 로그 세트 목록 조회 | 읽기 전용 |
| 로그 주제 목록 조회 | 읽기 전용 |
| 로그 주제 상세 구성 가져오기 | 읽기 전용 |
| 로그 주제의 인덱스 구성 조회 | 읽기 전용 |
| 머신 그룹 목록 조회 | 읽기 전용 |
| 머신 그룹 상세 정보 및 머신 온라인 상태 가져오기 | 읽기 전용 |
| 대시보드 목록 조회 | 읽기 전용 |
| CLS 지원 지역 목록 조회 | 읽기 전용 |
| 로그 세트 생성 | ⚠️ 쓰기 |
| 로그 주제 생성 | ⚠️ 쓰기 |
| 로그 주제 구성 수정 | ⚠️ 쓰기 |
| 로그 주제의 인덱스 구성 수정 | ⚠️ 쓰기 |
| 로그 세트 삭제(복구 불가) | 🚨 위험 |
| 로그 주제 및 모든 로그 데이터 삭제(복구 불가) | 🚨 위험 |
데이터 가공 (3개)
도구 이름 | 기능 설명 | 권한 |
| 데이터 가공 작업 목록 조회 | 읽기 전용 |
| 데이터 가공 작업 생성 | ⚠️ 쓰기 |
| 데이터 가공 작업 삭제 | 🚨 위험 |
정기 SQL (3개)
도구 이름 | 기능 설명 | 권한 |
| 정기 SQL 작업 목록 조회 | 읽기 전용 |
| 정기 SQL 분석 작업 생성 | ⚠️ 쓰기 |
| 정기 SQL 작업 삭제 | 🚨 위험 |
시간 도구 (1개)
도구 이름 | 기능 설명 | 권한 |
| 시간과 타임스탬프 상호 변환, 수동 계산 오류 방지 | 읽기 전용 |
권한 설명: 읽기 전용 도구는 기본적으로 활성화됩니다. ⚠️ 쓰기 도구는
CLS_ENABLE_WRITE=true설정이 필요하며, 🚨 위험 도구는CLS_ENABLE_WRITE=true와CLS_ENABLE_DANGEROUS=true를 모두 설정해야 합니다.
빠른 시작
사용 시나리오를 확인하고 해당 섹션을 선택하세요:
시나리오 | 설명 | 이동 |
로컬 사용 | 개인 컴퓨터에서 Claude Desktop / Cursor / VS Code 등 IDE와 함께 사용 | |
원격 서비스 | 서버에 배포하여 팀 공유 또는 원격 액세스 |
환경 준비
1. uv 설치 (Python 패키지 관리자)
uv는 매우 빠른 Python 패키지 관리자로, 본 프로젝트에서 권장합니다. 이미 설치되어 있다면 건너뛰어도 됩니다.
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# 安装完成后，让命令生效（二选一）：
source $HOME/.local/bin/env # 立即生效
# 或者关闭终端重新打开 # 重启终端也行# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"설치 성공 확인:
uv --version
# 预期输出: uv 0.11.x（版本号可能不同）uv가 없나요?
pip install cls-mcp-server로도 설치할 수 있지만, uv가 더 빠르고 Python 버전을 자동으로 관리할 수 있습니다.
2. 텐센트 클라우드 키 획득
텐센트 클라우드 콘솔 - API 키 관리에 접속하여 SecretId와 SecretKey를 획득하세요.
시나리오 1: 로컬 stdio 모드
개인 컴퓨터에서 사용하기 적합하며, MCP 클라이언트(Claude Desktop / Cursor 등)가 서버 프로세스를 자동으로 실행하므로 수동으로 서비스를 시작할 필요가 없습니다.
1단계: MCP 클라이언트 구성
사용 중인 클라이언트를 선택하고 다음 구성을 해당 구성 파일에 작성하세요:
구성 파일 위치:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"cls": {
"command": "uvx",
"args": ["cls-mcp-server"],
"env": {
"CLS_SECRET_ID": "替换为你的SecretId",
"CLS_SECRET_KEY": "替换为你的SecretKey",
"CLS_REGION": "ap-guangzhou"
}
}
}
}구성 파일 위치: ~/.cursor/mcp.json
{
"mcpServers": {
"cls": {
"command": "uvx",
"args": ["cls-mcp-server"],
"env": {
"CLS_SECRET_ID": "替换为你的SecretId",
"CLS_SECRET_KEY": "替换为你的SecretKey",
"CLS_REGION": "ap-guangzhou"
}
}
}
}VS Code의 settings.json에 추가:
{
"mcp": {
"servers": {
"cls": {
"command": "uvx",
"args": ["cls-mcp-server"],
"env": {
"CLS_SECRET_ID": "替换为你的SecretId",
"CLS_SECRET_KEY": "替换为你的SecretKey",
"CLS_REGION": "ap-guangzhou"
}
}
}
}
}설명:
uvx는 PyPI에서cls-mcp-server를 자동으로 다운로드하고 실행하므로 수동으로pip install할 필요가 없습니다.CLS_REGION을 로그가 위치한 지역(예:ap-shanghai,ap-beijing)으로 변경하세요.
2단계: 클라이언트 재시작
구성을 저장한 후 Claude Desktop / Cursor / VS Code를 재시작하면 클라이언트가 자동으로 CLS MCP 서버를 실행합니다.
3단계: 확인
클라이언트에서 메시지를 보내 테스트하세요:
帮我查看 CLS 支持哪些地域지역 목록(광저우, 상하이, 베이징 등)이 반환되면 연결에 성공한 것입니다.
기타 설치 방법
uvx를 사용하고 싶지 않다면 수동 설치 후 구성에서 cls-mcp-server 명령을 사용할 수 있습니다:
# 方式一：pip 安装（适合已有 pip 工作流的用户）
pip install cls-mcp-server
# 方式二：源码安装（适合需要修改源码的开发者）
git clone https://github.com/Tinker-LGD2026/cls-mcp-server.git
cd cls-mcp-server
uv sync
# 验证: uv run cls-mcp-server --helppip install로 설치한 후 클라이언트 구성에서 "command": "uvx"를 "command": "cls-mcp-server"로 변경하고 "args"를 []로 변경하면 됩니다.
시나리오 2: 원격 서비스 모드
서버에 배포하여 독립적인 HTTP 서비스로 실행하고 원격 MCP 클라이언트가 연결하도록 하는 데 적합합니다.
방법 1: Docker 배포 (권장, 가장 간단함)
명령어 하나로 시작할 수 있으며 Python이나 종속성을 설치할 필요가 없습니다:
docker run -d \
--name cls-mcp-server \
-p 8000:8000 \
-e CLS_SECRET_ID=替换为你的SecretId \
-e CLS_SECRET_KEY=替换为你的SecretKey \
-e CLS_REGION=ap-guangzhou \
ghcr.io/tinker-lgd2026/cls-mcp-server:latest서비스가 성공적으로 시작되었는지 확인:
curl http://localhost:8000/health
# 预期输出: {"status":"ok","version":"0.3.0","transport":"streamable-http"}방법 2: 원클릭 배포 스크립트 (Docker가 없는 가상 머신용)
CentOS 7+, Ubuntu 18.04+, Debian 10+를 지원하며, 스크립트가 자동으로 uv + Python 3.12 + 종속성 설치 + systemd 서비스 등록을 수행합니다. 사전 종속성 제로:
# 1. 将源码上传到服务器（git clone 或 tar.gz 打包上传）
git clone https://github.com/Tinker-LGD2026/cls-mcp-server.git
cd cls-mcp-server
# 2. 运行一键部署脚本
sudo bash deploy/systemd/install.sh
# 3. 编辑配置文件，填入真实密钥
sudo vim /opt/cls-mcp-server/.env
# 4. 启动服务
sudo systemctl start cls-mcp-server
# 5. 验证
curl http://127.0.0.1:8000/healthCentOS 7 사용자: Python 버전 문제를 걱정할 필요가 없습니다. 스크립트가 uv를 통해 Python 3.12를 자동으로 다운로드하며 시스템 기본 Python에는 영향을 주지 않습니다. git clone이 너무 느리면 로컬에서 패키징 후 scp로 업로드할 수 있습니다. 자세한 내용은 배포 매뉴얼 - systemd 배포를 참조하세요.
클라이언트 원격 서비스 연결
서비스 시작 후 MCP 클라이언트에서 원격 연결을 구성하세요:
{
"mcpServers": {
"cls": {
"url": "http://你的服务器IP:8000/mcp"
}
}
}SSE 모드(구버전 클라이언트 호환)가 필요한 경우 엔드포인트를
/sse로 변경하세요. Bearer Token 인증이 설정된 경우"headers": {"Authorization": "Bearer 당신의토큰"}을 추가해야 합니다.
구성 참조
환경 변수
변수 | 필수 | 기본값 | 설명 |
| 예 | — | 텐센트 클라우드 API SecretId |
| 예 | — | 텐센트 클라우드 API SecretKey |
| 예 |
| 지역(예: |
| 아니오 |
| 전송 방식: |
| 아니오 |
| HTTP 리스닝 주소(원격 모드) |
| 아니오 |
| HTTP 리스닝 포트(원격 모드) |
| 아니오 | — | HTTP Bearer Token 인증(원격 모드, 활성화 권장) |
| 아니오 |
| 쓰기 작업 도구 활성화(생성/수정) |
| 아니오 |
| 위험 작업 도구 활성화(삭제, 쓰기 작업도 함께 활성화 필요) |
| 아니오 |
| 로그 레벨: |
| 아니오 |
| SDK 요청 타임아웃(초) |
| 아니오 |
| 실패 재시도 최대 횟수(최초 호출 포함) |
| 아니오 |
| 재시도 기본 지연 시간(초), 실제 지연은 지수적으로 증가 |
| 아니오 |
| 서킷 브레이커 트리거 임계값: 연속 실패 횟수 |
| 아니오 |
| 서킷 브레이커 복구 타임아웃(초): 차단 후 복구 시도까지의 시간 |
| 아니오 | — | 도구 화이트리스트(쉼표 구분), 설정하지 않으면 모든 도구 등록, 아래 설명 참조 |
도구 화이트리스트 (CLS_ENABLED_TOOLS)
기본적으로 서버는 권한 등급에 맞는 모든 도구를 등록합니다. 일부 기능만 필요한 경우 CLS_ENABLED_TOOLS를 통해 등록할 도구를 정밀하게 제어할 수 있습니다. 나열되지 않은 도구는 등록되지 않으며 AI 어시스턴트가 호출할 수 없습니다.
구성 형식: 도구 이름을 쉼표로 구분하며, 이름은 위의 "도구 목록"에 있는 도구 이름과 정확히 일치해야 합니다.
# 只注册日志查询相关工具
CLS_ENABLED_TOOLS="cls_search_log,cls_get_log_context,cls_get_log_histogram,cls_get_log_count,cls_describe_search_syntax,cls_convert_time"
# 只注册告警管理相关工具
CLS_ENABLED_TOOLS="cls_describe_alarms,cls_describe_alarm_detail,cls_describe_alarm_notices,cls_describe_alarm_records,cls_get_alarm_detail"
# CLI 方式
cls-mcp-server --enabled-tools "cls_search_log,cls_get_log_context,cls_describe_topics,cls_describe_index"일반적인 시나리오 예시:
시나리오 | 권장 구성 |
로그 조회 및 분석만 수행 |
|
경보 모니터링만 수행 |
|
로그 조회 + 리소스 탐색 |
|
설정 안 함(기본값) | 모든 도구 등록 |
팁: 화이트리스트와 권한 제어(
CLS_ENABLE_WRITE/CLS_ENABLE_DANGEROUS)는 AND 관계이며, 둘 다 만족해야 등록됩니다. 존재하지 않는 도구 이름을 입력하면 시작 로그에 경고가 출력되지만 다른 도구 등록에는 영향을 주지 않습니다.
배포 가이드
위의 "빠른 시작"의 Docker 및 원클릭 스크립트 외에도 더 많은 배포 방식을 지원합니다:
방식 | 적용 시나리오 | 문서 |
Docker / Docker Compose | 원격 서비스, 프로덕션 환경 권장 | |
systemd + 원클릭 스크립트 | 기존 가상 머신(CentOS/Ubuntu) | |
Kubernetes / Helm | 컨테이너 오케스트레이션, 다중 복제본 수평 확장 | |
Nginx 리버스 프록시 + HTTPS | 프로덕션 환경 TLS 종료 | |
HTTP Bearer Token 인증 | 원격 서비스 액세스 제어 |
전체 배포 매뉴얼은 docs/deployment-guide.md를 참조하세요.
국내 환경 가속
pip / Docker / uv 다운로드 속도가 느린 경우:
# pip 使用清华源
pip install cls-mcp-server -i https://pypi.tuna.tsinghua.edu.cn/simple
# uv 使用国内源
UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple uvx cls-mcp-server --help더 많은 가속 솔루션(Docker 이미지 가속, uv 오프라인 설치, GitHub 프록시 등)은 배포 매뉴얼 - 국내 환경 가속을 참조하세요.
라이선스
Maintenance
–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseAqualityAmaintenanceProvides tools for accessing Alibaba Cloud observability products including SLS (Log Service) and ARMS (Application Real-time Monitoring Service), allowing any MCP-compatible AI assistants to quickly interact with these services.9160
- AlicenseAqualityDmaintenanceEnables AI assistants to query and analyze Alibaba Cloud SLS logs using natural language, supporting multiple log sources like Function Compute and ECS. It provides tools for searching logs, performing SQL analysis, and visualizing log distributions directly within Cursor or Claude.67110MIT
- FlicenseBqualityDmaintenanceEnables log analysis, searching, counting, and system metrics retrieval (CPU, memory, disk) via natural language, using 5 tools that can be integrated with Claude Code.5
Related MCP Connectors
A paid remote MCP for AI SDK data query MCP, built to return verdicts, receipts, usage logs, and aud
55 tools, 7 Resources, Sigma rules, email SPF/DMARC, MITRE, CVE/KEV, risk_score. No key.
Read-only access to Auralogs production logs: search logs, inspect errors, review AI analyses.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Tinker-LGD2026/cls-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server