691b8cdd0c
- 核心配置: IDENTITY, USER, SOUL, AGENTS, TOOLS, HEARTBEAT, MEMORY - memory/: 每日总结和临时记录 - skills/: 所有已安装技能 - notes/: 语音配置笔记
183 lines
8.6 KiB
Markdown
183 lines
8.6 KiB
Markdown
---
|
||
name: tencentcloud-lighthouse-skill
|
||
description: Manage Tencent Cloud Lighthouse (轻量应用服务器) — auto-setup mcporter + MCP, query instances, monitoring & alerting, self-diagnostics, firewall, snapshots, remote command execution (TAT). Use when user asks about Lighthouse or 轻量应用服务器. NOT for CVM or other cloud server types.
|
||
metadata:
|
||
{
|
||
"openclaw":
|
||
{
|
||
"emoji": "☁️",
|
||
"requires": {},
|
||
"install":
|
||
[
|
||
{
|
||
"id": "node-mcporter",
|
||
"kind": "node",
|
||
"package": "mcporter",
|
||
"bins": ["mcporter"],
|
||
"label": "Install mcporter (MCP CLI)",
|
||
},
|
||
],
|
||
},
|
||
}
|
||
---
|
||
|
||
# Lighthouse 云服务器运维
|
||
|
||
通过 mcporter + lighthouse-mcp-server 管理腾讯云轻量应用服务器。
|
||
|
||
## 首次使用 — 自动设置
|
||
|
||
当用户首次要求管理云服务器时，按以下流程操作：
|
||
|
||
### 步骤 1：检查当前状态
|
||
|
||
```bash
|
||
{baseDir}/scripts/setup.sh --check-only
|
||
```
|
||
|
||
如果输出显示一切 OK（mcporter 已安装、config 已配置、lighthouse 已就绪），跳到「调用格式」。
|
||
|
||
### 步骤 2：如果未配置，引导用户提供密钥
|
||
|
||
告诉用户：
|
||
> 我需要你的腾讯云 API 密钥来连接 Lighthouse 服务器。请提供：
|
||
> 1. **SecretId** — 腾讯云 API 密钥 ID
|
||
> 2. **SecretKey** — 腾讯云 API 密钥 Key
|
||
>
|
||
> 你可以在 [腾讯云控制台 > 访问管理 > API密钥管理](https://console.cloud.tencent.com/cam/capi) 获取。
|
||
|
||
### 步骤 3：用户提供密钥后，运行自动设置
|
||
|
||
```bash
|
||
{baseDir}/scripts/setup.sh --secret-id "<用户提供的SecretId>" --secret-key "<用户提供的SecretKey>"
|
||
```
|
||
|
||
脚本会自动：
|
||
- 检查并安装 mcporter（如未安装）
|
||
- 创建 `~/.mcporter/mcporter.json` 配置文件
|
||
- 写入 lighthouse MCP 服务器配置和密钥
|
||
- 验证连接
|
||
|
||
设置完成后即可开始使用。
|
||
|
||
## 调用格式
|
||
|
||
所有 mcporter 命令必须使用以下格式：
|
||
|
||
```
|
||
mcporter call lighthouse.<tool_name> --config ~/.mcporter/mcporter.json --output json [--args '<JSON>']
|
||
```
|
||
|
||
列出可用工具：
|
||
```
|
||
mcporter list lighthouse --config ~/.mcporter/mcporter.json --schema
|
||
```
|
||
|
||
|
||
## 工具总览
|
||
|
||
本 MCP Server 包含以下工具类别：
|
||
|
||
| 类别 | 说明 |
|
||
|------|------|
|
||
| 地域查询 | 获取可用地域列表（唯一不需要 Region 参数的操作） |
|
||
| 实例管理 | 查询、启动实例，查看流量包/套餐/配额等（需要 Region） |
|
||
| 监控与告警 | 获取多指标监控数据、设置告警策略、服务器自检（需要 Region） |
|
||
| 防火墙 | 规则增删改查、防火墙模板管理（需要 Region） |
|
||
| 远程命令(TAT) | 在实例上执行命令、查询任务状态（需要 Region） |
|
||
|
||
## 常用操作
|
||
|
||
> 以下所有示例省略了公共前缀 `mcporter call lighthouse.` 和 `--config ~/.mcporter/mcporter.json --output json`。
|
||
> 完整命令格式：`mcporter call lighthouse.<tool_name> --config ~/.mcporter/mcporter.json --output json --args '<JSON>'`
|
||
|
||
### 获取地域列表（不需要 Region 参数）
|
||
|
||
```bash
|
||
# 查询所有可用地域 — 唯一不需要 Region 参数的操作
|
||
# 首次使用时应先调用此接口获取可用 Region 列表
|
||
mcporter call lighthouse.describe_regions --config ~/.mcporter/mcporter.json --output json
|
||
```
|
||
|
||
### 实例管理
|
||
|
||
```bash
|
||
# 查询实例列表（Region 必填，可选参数: InstanceIds, Offset, Limit）
|
||
mcporter call lighthouse.describe_instances --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","Limit":20,"Offset":0}'
|
||
|
||
# 查询指定实例
|
||
mcporter call lighthouse.describe_instances --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceIds":["lhins-xxxxxxxx"]}'
|
||
|
||
# 启动实例
|
||
mcporter call lighthouse.start_instances --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceIds":["lhins-xxxxxxxx"]}'
|
||
|
||
# 获取实例登录终端地址
|
||
mcporter call lighthouse.describe_instance_login_url --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx"}'
|
||
|
||
# 查询所有应用镜像
|
||
mcporter call lighthouse.describe_all_applications --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou"}'
|
||
# BlueprintType 可选: APP_OS | PURE_OS | DOCKER | ALL（默认ALL）
|
||
```
|
||
|
||
### 监控与告警
|
||
|
||
```bash
|
||
# 获取监控数据（支持多指标同时查询，默认最近6小时）
|
||
mcporter call lighthouse.get_monitor_data --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","Indicators":["CPU利用率","内存利用率"]}'
|
||
|
||
# 获取监控数据（指定时间范围）
|
||
mcporter call lighthouse.get_monitor_data --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","Indicators":["公网出带宽","公网入带宽"],"StartTime":"2026-02-09 00:00:00","EndTime":"2026-02-10 00:00:00"}'
|
||
|
||
# 支持的监控指标（中文名称）:
|
||
# CPU利用率 | 内存利用率 | 公网出带宽 | 公网入带宽
|
||
# 系统盘读IO | 系统盘写IO | 公网流量包
|
||
|
||
# 设置告警策略
|
||
# Alarms 中的 Frequency/Points/Size 均为字符串类型
|
||
mcporter call lighthouse.set_alerting_strategy --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","Indicator":"CPU利用率","Alarms":[{"Frequency":"300","Threshold":"80%","Level":"严重","Points":"3","Size":"60"}],"PolicyName":"CPU高负载告警"}'
|
||
# Frequency(秒): "300"|"600"|"900"|"1800"|"3600"|"7200"|"10800"|"21600"|"43200"|"86400"
|
||
# Level: "提示"|"严重"|"紧急" Points: "1"-"5" Size: "60"|"300"
|
||
|
||
# 服务器自检（检测网络、防火墙、存储、状态、性能）
|
||
mcporter call lighthouse.self_test --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx"}'
|
||
```
|
||
|
||
### 防火墙
|
||
|
||
```bash
|
||
# 查询防火墙规则
|
||
mcporter call lighthouse.describe_firewall_rules --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx"}'
|
||
|
||
# 添加防火墙规则
|
||
mcporter call lighthouse.create_firewall_rules --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","FirewallRules":[{"Protocol":"TCP","Port":"8080","CidrBlock":"0.0.0.0/0","Action":"ACCEPT","FirewallRuleDescription":"开放8080端口"}]}'
|
||
|
||
# 删除防火墙规则
|
||
mcporter call lighthouse.delete_firewall_rules --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","FirewallRules":[{"Protocol":"TCP","Port":"8080"}]}'
|
||
```
|
||
|
||
### 远程命令执行 (TAT)
|
||
|
||
```bash
|
||
# 在 Linux 实例上执行命令
|
||
mcporter call lighthouse.execute_command --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","Command":"uptime && df -h && free -m","SystemType":"Linux"}'
|
||
|
||
# 在 Windows 实例上执行命令
|
||
mcporter call lighthouse.execute_command --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","Command":"Get-Process | Sort-Object CPU -Descending | Select-Object -First 10","SystemType":"Windows"}'
|
||
|
||
# 查询命令执行任务详情（自动轮询直到完成）
|
||
mcporter call lighthouse.describe_command_tasks --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InvocationTaskId":"invt-xxxxxxxx"}'
|
||
|
||
# 注意: Command 最大 2048 字符，超长命令建议登录实例手动执行
|
||
```
|
||
|
||
## 使用规范
|
||
|
||
1. **每次调用必须带** `--config ~/.mcporter/mcporter.json`
|
||
2. **始终加** `--output json` 获取结构化输出
|
||
3. **Region 参数规则**: 除 `describe_regions` 外，所有操作都**必须**传入 `Region` 参数。如果用户未指定 Region，应先调用 `describe_regions` 获取可用地域列表，再让用户选择或根据上下文确定
|
||
4. **首次使用流程**: 先调用 `describe_regions` 获取地域列表 → 再调用 `describe_instances` 获取实例列表 → 记住 InstanceId 和 Region 供后续使用
|
||
5. **用实际的 InstanceId** 替换示例中的 `lhins-xxxxxxxx`（先通过 `describe_instances` 获取）
|
||
6. **监控指标用中文**: `get_monitor_data` 的 Indicators 参数使用中文名称（CPU利用率、内存利用率等）
|
||
7. **命令长度限制**: `execute_command` 的 Command 参数最大 2048 字符，超长建议登录实例执行
|
||
8. **危险操作前先确认**: 防火墙修改、命令执行、实例关机/重启等，先向用户确认
|
||
9. **错误处理**: 如果调用失败，先用 `{baseDir}/scripts/setup.sh --check-only` 诊断问题，或用 `self_test` 检测实例状态 |