SWG bar MCP 使用指南
通过 Model Context Protocol (MCP) 将 AI 客户端连接至 SWG bar，查询 HTTPS 解密状态、检索证书信息并管理 SWG 绕过。
SWG bar · 更新日期
SWG bar 内置支持 Model Context Protocol (MCP)。通过 stdio 建立连接后，任何兼容 MCP 的 AI 客户端（如 Claude Desktop、Cursor、Windsurf、Claude Code 等）均可直接读取本地 SWG bar 状态、审查已观测的域名与证书证据，并在 macOS 上管理单域名 SWG 绕过规则。
配置 MCP 客户端
确保已将 SWG bar 安装至 /Applications/SWGBar.app，随后在你的 AI 客户端 MCP 配置文件中添加 swgbar 服务。
标准 mcp.json 配置
在客户端配置文件中（例如 Claude Desktop 的 claude_desktop_config.json 或 Cursor 的 .cursor/mcp.json）添加以下内容：
{
"mcpServers": {
"swgbar": {
"command": "/Applications/SWGBar.app/Contents/MacOS/swgbar",
"args": ["mcp"]
}
}
}命令行注册（Claude Code）
如果你使用 Claude Code，可在终端中执行单条命令直接完成注册：
claude mcp add swgbar -- /Applications/SWGBar.app/Contents/MacOS/swgbar mcp支持的核心能力
通过 MCP，你的 AI 助手可以调用与 SWG bar 菜单栏应用一致的底层能力：
| 领域 | 核心能力说明 |
|---|---|
| 概览指标 | 查询整体 HTTPS 解密占比、分类状态统计（Confirmed、Suspected、Public、Intranet）及主要拦截根证书。 |
| 域名查询 | 检索、过滤与分页浏览观测域名；审查指定域名的详细连接证据、证书信任链与当前绕过状态。 |
| 证书审查 | 列出并筛选证书聚类；查看签发者信息、有效期、SHA-256 指纹及所有关联域名。 |
| SWG 绕过 | 检查当前生效的绕过规则，为特定域名开启、切换、关闭或清空 SWG 绕过。 |
| 实时检测 | 对任意目标域名发起实时 TLS 探测，评估证书链并判断流量是否受到中间人解密。 |
| 浏览器插件 | 检查与 Chrome 扩展配套组件的连接与同步状态。 |
| 应用偏好 | 查看采集器状态、暂停或恢复监测、检查应用更新及查看许可证状态。 |
提示词使用示例
完成连接配置后，你可以在 AI 客户端中使用自然语言向 SWG bar 提问：
- “请帮我查询当前 SWG bar 的 HTTPS 解密占比，并列出正在拦截流量的根证书。”
- “列出所有当前标记为 Confirmed（确认解密）的域名，并显示它们的证书签发详情。”
- “检测
，告诉我它的证书链是公网原生证书还是被公司网关解密了。” - “为
启用 SWG 绕过，并确认最新的绕过状态。” - “最近的网络流量中是否有任何被标记为可疑（Suspected）的自签名或企业内部证书？”