Tencent Cloud APM

概述

APM 性能分析

通过腾讯云官方 SDK ApmClient.SendMCPMessage 接口连接 APM MCP Server，自动发现并调用 APM 性能分析工具，实现智能化性能诊断。

初始回答规范

用户首次提问（如「能做什么」「有什么功能」）时，按以下要点生成回答：

1. 说明通过腾讯云官方 SDK ApmClient.SendMCPMessage 连接远程 APM MCP Server
2. 说明需配置腾讯云凭证（SecretId/SecretKey），通过云API标准签名（TC3-HMAC-SHA256）自动鉴权
3. 末尾以表格形式列出 4–5 条示例引导，至少包含一条「查看 MCP 支持哪些操作」

快速开始

使用内嵌（vendored）官方 SDK，无需虚拟环境和 pip 安装：

python scripts/apm_mcp_client.py <command>

执行流程

1. 检查凭证 → 执行 echo $TENCENTCLOUD_SECRET_ID，缺失则按 references/credential_guide.md 中的格式模板引导配置
2. 验证连通性 → python scripts/apm_mcp_client.py ping
3. 发现工具 → python scripts/apm_mcp_client.py list-tools --output json
4. 展示工具列表 → 按 references/interaction_guide.md 格式规范呈现
5. 确认功能和参数 → 按 references/interaction_guide.md 交互规范与用户确认
6. 执行调用 → python scripts/apm_mcp_client.py call-tool --name <name> --args '{...}'
7. 解读结果 → 给出性能分析建议

核心命令

# 检测连通性
python scripts/apm_mcp_client.py ping

# 列出所有可用工具
python scripts/apm_mcp_client.py list-tools --output json

# 调用指定工具（JSON dict 自动转换为 APMKVItem 列表）
python scripts/apm_mcp_client.py call-tool --name <tool_name> --args '{"param1": "value1"}'

工具调用核心原则

1. 不得在未确认功能和参数的情况下直接调用工具
2. 上下文已有信息优先复用，避免重复询问
3. 可选参数必须列出，敏感参数一律通过环境变量配置

交互规范详见 references/interaction_guide.md

凭证与安全（强制规则）

凭证通过 shell 环境变量管理，不使用 .env 文件。通过云API标准签名（TC3-HMAC-SHA256）自动鉴权。

安全底线：

1. 禁止硬编码密钥，一律通过 shell 环境变量引用
2. 文档和对话中使用占位符 <your_secret_id> / <your_secret_key>
3. 用户提供密钥明文时不得回显，提示在终端中配置
4. 密钥不会写入任何项目文件或日志
5. 凭证缺失时，必须按 references/credential_guide.md 中定义的格式模板引导配置，不得自行编造格式

完整凭证配置与安全规则见 references/credential_guide.md

移动端兼容（强制规则）

本 Skill 支持移动端远程使用，全流程不得触发 IDE 确认弹窗。三条核心禁令：

1. 禁止创建临时文件 — 不得写入任何辅助脚本或数据文件
2. 禁止删除文件 — 不得执行 rm 等危险命令
3. 数据必须在对话中直接处理 — 使用 Markdown 表格/代码块/树形结构展示，不得借助外部脚本

完整规范与示例见 references/mobile_compat_guide.md

错误处理

调用失败时错误写入 ./logs/apm_error.log（JSON 格式，含错误码、RequestId、堆栈）。日志权限 600，不记录密钥。

日志格式和排错指引见 references/error_log_guide.md

调用决策表

Resources

scripts/

references/