直接向 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。