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）的自我簽署或企業內部憑證？”