Source: https://swgbar.com/zh-CN/mcp/
Language: zh-CN

# SWG bar MCP 使用指南

通过 Model Context Protocol (MCP) 将 AI 客户端连接至 SWG bar，查询 HTTPS 解密状态、检索证书信息并管理 SWG 绕过。

SWG bar · 更新日期 2026年10月31日

SWG bar 内置支持 **Model Context Protocol (MCP)**。通过 stdio 建立连接后，任何兼容 MCP 的 AI 客户端（如 Claude Desktop、Cursor、Windsurf、Claude Code 等）均可直接读取本地 SWG bar 状态、审查已观测的域名与证书证据，并在 macOS 上管理单域名 SWG 绕过规则。

## 配置 MCP 客户端

确保已将 [SWG bar 安装](<https://swgbar.com/zh-CN/install/>)至 `/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）的自签名或企业内部证书？”_

如需在终端中直接使用命令行，请参见 [CLI 使用指南](<https://swgbar.com/zh-CN/cli/>)；关于证书证据与判定的详细机制，请阅读[工作原理](<https://swgbar.com/zh-CN/how-it-works/>)。

## 继续阅读

*   [如何在 Mac 上绕过 SWG](<https://swgbar.com/zh-CN/guides/how-to-bypass-swg/>)
*   [如何检测 Mac 上的 HTTPS 检查](<https://swgbar.com/zh-CN/guides/detect-https-inspection/>)
*   [SWG 绕过与 TLS 解密例外有什么区别](<https://swgbar.com/zh-CN/guides/swg-bypass-vs-tls-exception/>)
*   [SWG bar 如何检查 HTTPS 解密](<https://swgbar.com/zh-CN/how-it-works/>)
*   [在 Mac 上安装 SWG bar](<https://swgbar.com/zh-CN/install/>)
*   [连接 SWG bar Chrome 扩展](<https://swgbar.com/zh-CN/chrome-extension/>)
*   [SWG bar CLI 使用指南](<https://swgbar.com/zh-CN/cli/>)
*   [SWG bar 版本信息](<https://swgbar.com/zh-CN/releases/>)
*   [关于 SWG bar](<https://swgbar.com/zh-CN/about/>)