lafine1211/roamswitch-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

0 stars 0 forks 质量 76 趋势 20MIT

Repository Install

仅读MCP服务器和RoamSwitch（macOS网络安全应用）的检测逻辑——一个可验证的独立镜像。麻省理工学院。

概览

RoamSwitch背后的原理——一款macOS菜单栏应用，能自动保护你的Mac网络边界——发布后，你可以准确读取它计算的内容以及它向AI客户端暴露的内容。这个仓库是RoamSwitch应用中对应源代码的。它不是应用本身：没有特权助手，没有包过滤（pf）控制，没有实际阻挡流量的守卫，没有许可证或付款代码，没有界面。只有观察代码和回答标准测试问题的代码。 33个工具（与MCPServer.swift中toolDefinitions的长度相当，工具/列表返回的定义）。每个工具都是只读的。get_exposed_ports和opt-in run_active_vuln_scan都钉在127.0.0.1上;唯一会联系外部主机的工具是opt-in的Pro-only-run_npm_audit_signatures，它会对npm注册表运行npm审计签名。

概述（AI 翻译）

英语 |日本語

背后的MCP服务器和检测逻辑 RoamSwitch ——一款macOS菜单栏应用，自动保护你的Mac。网络边界——发布以便你准确读取它计算的内容以及暴露给 AI客户端。

该仓库是RoamSwitch应用中对应源的可验证镜像。它不是应用本身：没有特权辅助，没有包过滤（pf）控制，也没有实际的守护阻断流量，没有许可证或支付码，没有界面。只有那个观察的代码和 通过标准回答问题。

这里有什么

区域	档案
MCP stdio 服务器（手工卷制的 JSON-RPC 2.0）	[`main.swift`， `MCPProtocol.swift`， `MCPServer.swift`， `MCPResponseFormatting.swift`
网络信任 / 网关指纹	`TrustedNetwork.swift`， `GatewayFingerprint.swift`
ARP欺骗检测	`ARPSpoofMonitor.swift`
监听端口枚举与审计	`ListeningPortMonitor.swift`， `PortSecurityAuditor.swift`， `ServiceSignatures.swift`
Wi-Fi加密检查	`WiFiSecurityMonitor.swift`
22点macOS安全态势	`SecurityHealthChecker.swift`， '备份新近。

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

roamswitch-mcp

English | 日本語

The MCP server and the detection logic behind RoamSwitch — a macOS menu-bar app that automatically defends your Mac’s network boundary — published so you can read exactly what it computes and what it exposes to an AI client.

This repository is a verifiable mirror of the corresponding source in the RoamSwitch app. It is not the app: no privileged helper, no packet-filter (pf) control, no guards that actually block traffic, no license or payment code, no UI. Just the code that observes and the code that answers questions over stdio.

What’s here

Area	Files
MCP stdio server (hand-rolled JSON-RPC 2.0)	`main.swift`, `MCPProtocol.swift`, `MCPServer.swift`, `MCPResponseFormatting.swift`
Network trust / gateway fingerprint	`TrustedNetwork.swift`, `GatewayFingerprint.swift`
ARP spoofing detection	`ARPSpoofMonitor.swift`
Listening-port enumeration & audit	`ListeningPortMonitor.swift`, `PortSecurityAuditor.swift`, `ServiceSignatures.swift`
Wi-Fi encryption check	`WiFiSecurityMonitor.swift`
22-point macOS security posture	`SecurityHealthChecker.swift`, `BackupRecency.swift`, `ProxyAutoDiscoveryCheck.swift`, `TrustAnchorCheck.swift`, `AgentCredentialFileCheck.swift`
Phishing / homograph / URL safety (offline)	`LinkSafetyAuditor.swift`
Secret / API-key leak scanning (offline)	`SecretLeakScanning.swift`
Unified-log security audit + log-template anomalies	`SecurityLogAuditor.swift`, `LogTemplateAnalyzer.swift`
Active vulnerability verification (`127.0.0.1` only, opt-in)	`ActiveVulnScan.swift`, `ActiveVulnCveMapData.swift`
Dependency source check, EPSS ranking, accepted-risk records	`DependencySourceScan.swift`, `PackageCveEpss.swift`, `VulnerabilityAcceptance.swift`
Local, network-free CVE matching (Homebrew + lockfiles)	`PackageCveScan.swift`, `PackageCveMapData.swift`, `PackageCveScanLanguages.swift`, `PackageCveMapLanguagesData.swift`
Guard state readers (quarantine, canary, port anomaly, runtime threat, notifications, containment timeline, network history)	`QuarantineManager.swift`, `CanaryStatusReader.swift`, `PortAnomalyStatusReader.swift`, `RuntimeThreatStatusReader.swift`, `NotificationHistory.swift`, `ContainmentIncidentTimeline.swift`, `NetworkHistoryGuard.swift`
Bundled knowledge base (`get_app_help`)	`RoamSwitchKnowledgeBase.swift`
Localization plumbing	`AppLanguage.swift`
Tests	`Tests/roamswitch-mcpTests/` — mirrored unit tests + `StdioSmokeTests.swift`

Tools exposed (`tools/list`)

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

// Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "roamswitch": {
      "command": "/absolute/path/to/roamswitch-mcp/.build/release/roamswitch-mcp"
    }
  }
}