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

# 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-TW/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-TW/cli/>)；關於憑證證據與判定的詳細機制，請閱讀[運作原理](<https://swgbar.com/zh-TW/how-it-works/>)。

## 延伸閱讀

*   [如何在 Mac 上繞過 SWG](<https://swgbar.com/zh-TW/guides/how-to-bypass-swg/>)
*   [如何偵測 Mac 上的 HTTPS 檢查](<https://swgbar.com/zh-TW/guides/detect-https-inspection/>)
*   [SWG 繞過與 TLS 解密例外有什麼區別](<https://swgbar.com/zh-TW/guides/swg-bypass-vs-tls-exception/>)
*   [SWG bar 如何檢查 HTTPS 解密](<https://swgbar.com/zh-TW/how-it-works/>)
*   [在 Mac 上安裝 SWG bar](<https://swgbar.com/zh-TW/install/>)
*   [連線 SWG bar Chrome 擴充功能](<https://swgbar.com/zh-TW/chrome-extension/>)
*   [SWG bar CLI 使用指南](<https://swgbar.com/zh-TW/cli/>)
*   [SWG bar 版本資訊](<https://swgbar.com/zh-TW/releases/>)
*   [關於 SWG bar](<https://swgbar.com/zh-TW/about/>)