cls-mcp-server 0.1.7__tar.gz

cls_mcp_server-0.1.7/.dockerignore

@@ -0,0 +1,51 @@
+# Git
+.git
+.gitignore
+
+# Python
+__pycache__
+*.pyc
+*.pyo
+*.egg-info
+.eggs
+dist
+build
+
+# Virtual environments
+.venv
+venv
+env
+
+# IDE
+.vscode
+.idea
+*.swp
+*.swo
+
+# Testing
+tests
+.pytest_cache
+.coverage
+htmlcov
+
+# Documentation
+docs
+
+# CI/CD
+.github
+
+# Environment files (secrets should be injected at runtime)
+.env
+.env.local
+
+# Deploy configs (not needed inside container)
+deploy
+
+# Other
+*.md
+!README.md
+LICENSE
+.codebuddy
+cls-search-log-test
+*.tar.gz
+需求大纲

cls_mcp_server-0.1.7/.env.example

@@ -0,0 +1,36 @@
+# 腾讯云 CLS MCP Server 配置
+# ==============================
+
+# [必填] 腾讯云 API 密钥
+CLS_SECRET_ID=your-secret-id-here
+CLS_SECRET_KEY=your-secret-key-here
+
+# [必填] 地域，默认 ap-guangzhou
+CLS_REGION=ap-guangzhou
+
+# [可选] 传输方式: stdio | sse | streamable-http，默认 stdio
+CLS_TRANSPORT=stdio
+
+# [可选] HTTP 监听端口（SSE/Streamable HTTP 模式），默认 8000
+# 向后兼容 CLS_SSE_PORT
+CLS_PORT=8000
+
+# [可选] HTTP 监听地址（SSE/Streamable HTTP 模式），默认 0.0.0.0
+# 向后兼容 CLS_SSE_HOST
+CLS_HOST=0.0.0.0
+
+# [可选] Streamable HTTP 无状态模式，推荐 K8s 部署时开启，默认 true
+CLS_STATELESS_HTTP=true
+
+# [可选] 权限控制
+# 设置为 true 开启写操作工具（创建、修改）
+CLS_ENABLE_WRITE=false
+# 设置为 true 开启高危操作工具（删除）
+CLS_ENABLE_DANGEROUS=false
+
+# [可选] HTTP Bearer Token 认证（SSE/Streamable HTTP 模式）
+# 设置后，客户端请求需带 Authorization: Bearer <token> 头
+# MCP_AUTH_TOKEN=your-secret-token-here
+
+# [可选] 日志级别: DEBUG | INFO | WARNING | ERROR
+CLS_LOG_LEVEL=INFO

cls_mcp_server-0.1.7/.github/workflows/docker-publish.yml

@@ -0,0 +1,73 @@
+# ============================================================
+# Docker 镜像自动构建与推送工作流
+# ============================================================
+# 触发条件：推送以 v 开头的 Tag（如 v0.1.0、v1.0.0）
+#
+# 推送到 GitHub Container Registry (ghcr.io)，免费且无需额外账号。
+#
+# GHCR（GitHub Container Registry）：
+#   - 无需额外配置，使用 GITHUB_TOKEN 自动认证
+# ============================================================
+
+name: Build and Push Docker Image
+
+on:
+  push:
+    tags:
+      - "v*"
+
+env:
+  # GHCR 镜像名（自动根据仓库名生成）
+  GHCR_IMAGE: ghcr.io/${{ github.repository }}
+
+jobs:
+  build-and-push:
+    name: Build & Push Docker Image
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write  # 推送到 GHCR 需要此权限
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Docker Logout
+        run: docker logout || true
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      # 登录 GHCR
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      # 提取版本标签
+      - name: Extract metadata (tags, labels)
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            ${{ env.GHCR_IMAGE }}
+          tags: |
+            # v1.0.0 -> 1.0.0, latest
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      # 构建并推送（多平台）
+      - name: Build and Push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: deploy/docker/Dockerfile
+          push: true
+          platforms: linux/amd64,linux/arm64
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

cls_mcp_server-0.1.7/.github/workflows/pypi-publish.yml

@@ -0,0 +1,82 @@
+# ============================================================
+# PyPI 自动发布工作流
+# ============================================================
+# 触发条件：推送以 v 开头的 Tag（如 v0.1.0、v1.0.0）
+# 前提：需要在 GitHub 仓库 Settings > Secrets 中配置 PYPI_API_TOKEN
+#
+# 获取 PyPI Token 步骤：
+#   1. 注册 https://pypi.org 账号
+#   2. 进入 Account Settings > API tokens
+#   3. 创建 token（Scope 选 Entire account 或指定项目）
+#   4. 复制 token，到 GitHub 仓库 Settings > Secrets and variables > Actions
+#   5. 点 "New repository secret"，Name 填 PYPI_API_TOKEN，Value 粘贴 token
+# ============================================================
+
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-and-publish:
+    name: Build & Publish to PyPI
+    runs-on: ubuntu-latest
+    # 推荐：使用 GitHub 的 Trusted Publisher（OIDC），更安全
+    # 如果配置了 Trusted Publisher，可以去掉 password，改用 permissions
+    permissions:
+      contents: read
+      id-token: write  # 用于 Trusted Publisher（可选）
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Extract version from tag
+        id: version
+        run: |
+          TAG="${GITHUB_REF#refs/tags/v}"
+          echo "version=$TAG" >> "$GITHUB_OUTPUT"
+          echo "Building version: $TAG"
+
+      - name: Verify version consistency
+        run: |
+          TAG_VERSION="${{ steps.version.outputs.version }}"
+          PKG_VERSION=$(python -c "
+          import tomllib
+          with open('pyproject.toml', 'rb') as f:
+              data = tomllib.load(f)
+          print(data['project']['version'])
+          ")
+          echo "Tag version: $TAG_VERSION"
+          echo "Package version: $PKG_VERSION"
+          if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
+            echo "::error::Version mismatch! Tag=$TAG_VERSION, pyproject.toml=$PKG_VERSION"
+            exit 1
+          fi
+
+      - name: Build package
+        run: python -m build
+
+      - name: Verify build artifacts
+        run: |
+          ls -la dist/
+          pip install dist/*.whl
+          cls-mcp-server --help
+
+      # 方式一：使用 API Token（推荐新手使用）
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          # 首次发布前，可先发到 TestPyPI 验证：
+          # repository-url: https://test.pypi.org/legacy/

cls_mcp_server-0.1.7/.gitignore

@@ -0,0 +1,26 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.env
+.venv/
+venv/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+*.log
+.DS_Store
+.idea/
+.vscode/
+.codebuddy/
+
+# 打包产物
+*.tar.gz
+
+# 临时文件
+需求大纲
+cls-search-log-test/

cls_mcp_server-0.1.7/PKG-INFO

@@ -0,0 +1,398 @@
+Metadata-Version: 2.4
+Name: cls-mcp-server
+Version: 0.1.7
+Summary: 腾讯云 CLS 日志服务 MCP Server - 从可观测性视角为 AI 助手提供全方位日志服务能力
+Project-URL: Homepage, https://github.com/Tinker-LGD2026/cls-mcp-server
+Project-URL: Repository, https://github.com/Tinker-LGD2026/cls-mcp-server
+Project-URL: Issues, https://github.com/Tinker-LGD2026/cls-mcp-server/issues
+Author: tinkerli
+License: Apache-2.0
+Keywords: cls,log-service,mcp,observability,tencent-cloud
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp[cli]>=1.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: tencentcloud-sdk-python-cls>=1.0.0
+Requires-Dist: tencentcloud-sdk-python-region>=3.0.0
+Description-Content-Type: text/markdown
+
+# CLS MCP Server
+
+腾讯云日志服务（Cloud Log Service）MCP Server —— 从可观测性视角为 AI 助手提供全方位日志服务能力。
+
+## 功能特性
+
+- **日志查询分析**：CQL 检索 + SQL 管道分析、上下文查看、直方图、日志计数
+- **指标查询**：PromQL 兼容的单时间点/时间范围指标查询
+- **告警管理**：告警策略/通知渠道/告警记录查询与管理
+- **资源管理**：日志集、日志主题、索引、机器组、仪表盘的增删改查
+- **数据加工 & 定时 SQL**：数据加工任务和定时 SQL 任务管理
+- **三级权限控制**：READ（默认）/ WRITE / DANGER 分级保护
+
+共 **37 个工具**，覆盖 CLS 日志服务的完整能力。
+
+## 工具清单
+
+### 日志检索（5 个）
+
+| 工具名称 | 功能说明 | 权限 |
+|---------|---------|------|
+| `cls_search_log` | 检索分析 CLS 日志，支持 CQL 语法检索和 SQL 管道分析 | 只读 |
+| `cls_get_log_context` | 获取日志上下文，查看目标日志前后的记录 | 只读 |
+| `cls_get_log_histogram` | 获取日志数量直方图，观察日志量随时间的分布 | 只读 |
+| `cls_get_log_count` | 快速获取日志数量，比 search_log 更快 | 只读 |
+| `cls_describe_search_syntax` | 获取 CLS 日志检索语法参考和常用查询模板 | 只读 |
+
+### 指标查询（3 个）
+
+| 工具名称 | 功能说明 | 权限 |
+|---------|---------|------|
+| `cls_query_metric` | 查询指标数据（单时间点），支持 PromQL 语法 | 只读 |
+| `cls_query_range_metric` | 查询指标数据（时间范围），获取指标变化趋势 | 只读 |
+| `cls_list_metrics` | 列出指标主题下的所有可用指标名称 | 只读 |
+
+### 告警管理（8 个）
+
+| 工具名称 | 功能说明 | 权限 |
+|---------|---------|------|
+| `cls_describe_alarms` | 查询告警策略列表，支持分页和过滤 | 只读 |
+| `cls_describe_alarm_detail` | 根据告警策略 ID 获取完整告警配置 | 只读 |
+| `cls_describe_alarm_notices` | 查询告警通知渠道列表（邮件、短信、回调等） | 只读 |
+| `cls_describe_alarm_records` | 查询告警历史触发记录 | 只读 |
+| `cls_get_alarm_detail` | 通过告警详情 URL 获取告警详细信息 | 只读 |
+| `cls_create_alarm` | 创建告警策略 | ⚠️ 写入 |
+| `cls_modify_alarm` | 修改告警策略配置 | ⚠️ 写入 |
+| `cls_delete_alarm` | 删除告警策略（不可恢复） | 🚨 危险 |
+
+### 资源管理（14 个）
+
+| 工具名称 | 功能说明 | 权限 |
+|---------|---------|------|
+| `cls_describe_logsets` | 查询日志集列表 | 只读 |
+| `cls_describe_topics` | 查询日志主题列表 | 只读 |
+| `cls_describe_topic_detail` | 获取日志主题详细配置 | 只读 |
+| `cls_describe_index` | 查询日志主题的索引配置 | 只读 |
+| `cls_describe_machine_groups` | 查询机器组列表 | 只读 |
+| `cls_describe_machine_group_detail` | 获取机器组详情和机器在线状态 | 只读 |
+| `cls_describe_dashboards` | 查询仪表盘列表 | 只读 |
+| `cls_describe_regions` | 查询 CLS 支持的地域列表 | 只读 |
+| `cls_create_logset` | 创建日志集 | ⚠️ 写入 |
+| `cls_create_topic` | 创建日志主题 | ⚠️ 写入 |
+| `cls_modify_topic` | 修改日志主题配置 | ⚠️ 写入 |
+| `cls_modify_index` | 修改日志主题的索引配置 | ⚠️ 写入 |
+| `cls_delete_logset` | 删除日志集（不可恢复） | 🚨 危险 |
+| `cls_delete_topic` | 删除日志主题及所有日志数据（不可恢复） | 🚨 危险 |
+
+### 数据加工（3 个）
+
+| 工具名称 | 功能说明 | 权限 |
+|---------|---------|------|
+| `cls_describe_data_transform_tasks` | 查询数据加工任务列表 | 只读 |
+| `cls_create_data_transform` | 创建数据加工任务 | ⚠️ 写入 |
+| `cls_delete_data_transform` | 删除数据加工任务 | 🚨 危险 |
+
+### 定时 SQL（3 个）
+
+| 工具名称 | 功能说明 | 权限 |
+|---------|---------|------|
+| `cls_describe_scheduled_sql_tasks` | 查询定时 SQL 任务列表 | 只读 |
+| `cls_create_scheduled_sql` | 创建定时 SQL 分析任务 | ⚠️ 写入 |
+| `cls_delete_scheduled_sql` | 删除定时 SQL 任务 | 🚨 危险 |
+
+### 时间工具（1 个）
+
+| 工具名称 | 功能说明 | 权限 |
+|---------|---------|------|
+| `cls_convert_time` | 时间与时间戳互转，避免手动计算出错 | 只读 |
+
+> **权限说明**：只读工具默认启用；⚠️ 写入工具需设置 `CLS_ENABLE_WRITE=true`；🚨 危险工具需同时设置 `CLS_ENABLE_WRITE=true` 和 `CLS_ENABLE_DANGEROUS=true`。
+
+## 快速开始
+
+先确认你的使用场景，选择对应章节：
+
+| 场景 | 说明 | 跳转 |
+|------|------|------|
+| **本地使用** | 在自己电脑上配合 Claude Desktop / Cursor / VS Code 等 IDE 使用 | [场景一：本地 stdio 模式](#场景一本地-stdio-模式) |
+| **远程服务** | 部署到服务器，团队共用或远程访问 | [场景二：远程服务模式](#场景二远程服务模式) |
+
+---
+
+### 环境准备
+
+#### 1. 安装 uv（Python 包管理器）
+
+[uv](https://docs.astral.sh/uv/) 是一个极快的 Python 包管理器，本项目推荐使用。如已安装可跳过。
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# 安装完成后，让命令生效（二选一）：
+source $HOME/.local/bin/env    # 立即生效
+# 或者关闭终端重新打开          # 重启终端也行
+```
+
+```powershell
+# Windows (PowerShell)
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+验证安装成功：
+
+```bash
+uv --version
+# 预期输出: uv 0.11.x（版本号可能不同）
+```
+
+> **没有 uv？** 也可以用 `pip install cls-mcp-server` 安装，但 uv 更快且能自动管理 Python 版本。
+
+#### 2. 获取腾讯云密钥
+
+访问 [腾讯云控制台 - API 密钥管理](https://console.cloud.tencent.com/cam/capi)，获取 `SecretId` 和 `SecretKey`。
+
+---
+
+### 场景一：本地 stdio 模式
+
+适合在自己电脑上使用，MCP 客户端（Claude Desktop / Cursor 等）自动拉起 Server 进程，无需手动启动服务。
+
+#### 第一步：配置 MCP 客户端
+
+选择你使用的客户端，将以下配置写入对应的配置文件：
+
+<details>
+<summary><b>Claude Desktop</b></summary>
+
+配置文件位置：
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "cls": {
+      "command": "uvx",
+      "args": ["cls-mcp-server"],
+      "env": {
+        "CLS_SECRET_ID": "替换为你的SecretId",
+        "CLS_SECRET_KEY": "替换为你的SecretKey",
+        "CLS_REGION": "ap-guangzhou"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Cursor</b></summary>
+
+配置文件位置：`~/.cursor/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "cls": {
+      "command": "uvx",
+      "args": ["cls-mcp-server"],
+      "env": {
+        "CLS_SECRET_ID": "替换为你的SecretId",
+        "CLS_SECRET_KEY": "替换为你的SecretKey",
+        "CLS_REGION": "ap-guangzhou"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>VS Code (Copilot)</b></summary>
+
+在 VS Code 的 `settings.json` 中添加：
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "cls": {
+        "command": "uvx",
+        "args": ["cls-mcp-server"],
+        "env": {
+          "CLS_SECRET_ID": "替换为你的SecretId",
+          "CLS_SECRET_KEY": "替换为你的SecretKey",
+          "CLS_REGION": "ap-guangzhou"
+        }
+      }
+    }
+  }
+}
+```
+
+</details>
+
+> **说明**：`uvx` 会自动从 PyPI 下载并运行 `cls-mcp-server`，无需手动 `pip install`。`CLS_REGION` 改为你的日志所在地域（如 `ap-shanghai`、`ap-beijing`）。
+
+#### 第二步：重启客户端
+
+保存配置后，**重启** Claude Desktop / Cursor / VS Code，客户端会自动拉起 CLS MCP Server。
+
+#### 第三步：验证
+
+在客户端中发送一条消息测试：
+
+```
+帮我查看 CLS 支持哪些地域
+```
+
+如果返回了地域列表（广州、上海、北京等），说明连接成功。
+
+#### 其他安装方式
+
+如果不想用 `uvx`，也可以手动安装后在配置中使用 `cls-mcp-server` 命令：
+
+```bash
+# 方式一：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 --help
+```
+
+使用 `pip install` 安装后，客户端配置中把 `"command": "uvx"` 改为 `"command": "cls-mcp-server"`，`"args"` 改为 `[]` 即可。
+
+---
+
+### 场景二：远程服务模式
+
+适合将 Server 部署到服务器上，作为独立 HTTP 服务运行，供远程 MCP 客户端连接。
+
+#### 方式一：Docker 部署（推荐，最简单）
+
+一条命令即可启动，无需安装 Python 或任何依赖：
+
+```bash
+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
+```
+
+验证服务是否启动成功：
+
+```bash
+curl http://localhost:8000/health
+# 预期输出: {"status":"ok","version":"0.1.0","transport":"streamable-http"}
+```
+
+#### 方式二：一键部署脚本（适合无 Docker 的虚拟机）
+
+支持 CentOS 7+、Ubuntu 18.04+、Debian 10+，脚本自动安装 uv + Python 3.12 + 依赖 + 注册 systemd 服务，**零前置依赖**：
+
+```bash
+# 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/health
+```
+
+> **CentOS 7 用户**：不用担心 Python 版本问题，脚本通过 uv 自动下载 Python 3.12，不影响系统自带 Python。如果 git clone 太慢，可以在本地打包后 scp 上传，详见 [部署手册 - systemd 部署](docs/deployment-guide.md#43-systemd-服务虚拟机部署)。
+
+#### 客户端连接远程服务
+
+服务启动后，在 MCP 客户端中配置远程连接：
+
+```json
+{
+  "mcpServers": {
+    "cls": {
+      "url": "http://你的服务器IP:8000/mcp"
+    }
+  }
+}
+```
+
+> 如需 SSE 模式（兼容旧版客户端），端点改为 `/sse`。如已设置 Bearer Token 认证，需添加 `"headers": {"Authorization": "Bearer 你的token"}`。
+
+---
+
+## 配置参考
+
+### 环境变量
+
+| 变量 | 必填 | 默认值 | 说明 |
+|------|------|--------|------|
+| `CLS_SECRET_ID` | 是 | — | 腾讯云 API SecretId |
+| `CLS_SECRET_KEY` | 是 | — | 腾讯云 API SecretKey |
+| `CLS_REGION` | 是 | `ap-guangzhou` | 地域（如 `ap-shanghai`、`ap-beijing`） |
+| `CLS_TRANSPORT` | 否 | `stdio` | 传输方式：`stdio` / `sse` / `streamable-http` |
+| `CLS_HOST` | 否 | `0.0.0.0` | HTTP 监听地址（远程模式） |
+| `CLS_PORT` | 否 | `8000` | HTTP 监听端口（远程模式） |
+| `MCP_AUTH_TOKEN` | 否 | — | HTTP Bearer Token 认证（远程模式，建议开启） |
+| `CLS_ENABLE_WRITE` | 否 | `false` | 启用写操作工具（创建/修改） |
+| `CLS_ENABLE_DANGEROUS` | 否 | `false` | 启用危险操作工具（删除，需同时开启写操作） |
+| `CLS_LOG_LEVEL` | 否 | `INFO` | 日志级别：`DEBUG` / `INFO` / `WARNING` / `ERROR` |
+
+---
+
+## 部署指南
+
+除了上面"快速开始"中的 Docker 和一键脚本，还支持更多部署方式：
+
+| 方式 | 适用场景 | 文档 |
+|------|----------|------|
+| Docker / Docker Compose | 远程服务，生产环境推荐 | [详细说明](docs/deployment-guide.md#5-docker-部署) |
+| systemd + 一键脚本 | 传统虚拟机（CentOS/Ubuntu） | [详细说明](docs/deployment-guide.md#43-systemd-服务虚拟机部署) |
+| Kubernetes / Helm | 容器编排，多副本水平扩展 | [详细说明](docs/deployment-guide.md#6-kubernetes-部署) |
+| Nginx 反向代理 + HTTPS | 生产环境 TLS 终结 | [详细说明](docs/deployment-guide.md#44-nginx-反向代理) |
+| HTTP Bearer Token 认证 | 远程服务访问控制 | [详细说明](docs/deployment-guide.md#7-http-认证bearer-token) |
+
+完整部署手册请参考 [docs/deployment-guide.md](docs/deployment-guide.md)。
+
+---
+
+## 国内环境加速
+
+如果 pip / Docker / uv 下载速度慢：
+
+```bash
+# 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 代理等）请参考 [部署手册 - 国内环境加速](docs/deployment-guide.md#9-国内环境加速)。
+
+## 许可证
+
+[Apache-2.0](LICENSE)