直接向 Claude 等 AI 查詢您 Mac / Linux 的安全狀態

1二進位檔案位置

已內建於 apt / rpm / AUR 套件中，安裝時會自動部署為 /usr/bin/roamswitch-mcp，無需另外下載或編譯（用戶端版與 Server Edition 通用）。

/usr/bin/roamswitch-mcp

Server Edition（無頭運作模式）也可直接使用相同的二進位檔案與相同的設定方法。詳情請參閱《Linux Server 維運手冊》中的「AI 代理 / MCP 整合維運」章節。

2a適用於 Claude Desktop

Claude Desktop 官方並未提供 Linux 版本。若您使用的是非官方組建版本（例如 claude-desktop-debian 等），請在 ~/.config/Claude/claude_desktop_config.json 的 "mcpServers" 中新增以下內容後重新啟動。

{
  "mcpServers": {
    "roamswitch": {
      "command": "/usr/bin/roamswitch-mcp"
    }
  }
}

2b適用於 Claude Code

只需在終端機中執行一次以下指令即可。

claude mcp add roamswitch /usr/bin/roamswitch-mcp

2c適用於 OpenAI Codex CLI

請在 ~/.codex/config.toml 中新增以下內容，或在終端機中執行以下指令。

[mcp_servers.roamswitch]
command = "/usr/bin/roamswitch-mcp"

codex mcp add roamswitch -- /usr/bin/roamswitch-mcp

2d適用於 OpenCode

在專案根目錄下的 opencode.json（或全域設定 ~/.config/opencode/opencode.json）中新增以下內容：

{
  "mcp": {
    "roamswitch": {
      "type": "local",
      "command": ["/usr/bin/roamswitch-mcp"]
    }
  }
}

💡 本機大模型支援: 搭配Ollama或LM Studio等本機模型時，即使RoamSwitch因偵測到威脅而實施緊急斷網，亦能在完全離線狀態下即時查詢安全建議與事件分析。

2e適用於 Antigravity

請在 ~/.gemini/config/mcp_config.json（或工作區根目錄的 .agents/mcp_config.json）中新增以下內容。

{
  "mcpServers": {
    "roamswitch": {
      "command": "/usr/bin/roamswitch-mcp"
    }
  }
}

* 注意：若在 Antigravity CLI (agy) 中執行工具時遇到 Hook Failure 或遙測錯誤，請在 ~/.gemini/config/plugins/.../hooks.json 中將 "enabled": false 以停用該 Hook。