MCP Homescan Server

MCP-Server für die Erkennung von Heimnetzwerken und Sicherheits-Scans. Er erkennt Geräte in Ihrem lokalen Netzwerk, identifiziert Hersteller, markiert potenzielle Sicherheitsbedenken und exportiert sie in das Obsidian-Inventarformat.

Warum dieses Tool verwenden?

Wenn Sie ein Heim- oder kleines Büronetzwerk verwalten, ermöglicht Ihnen dieser MCP-Server:

• Alle Geräte entdecken - Finden Sie alles, was mit Ihrem Netzwerk verbunden ist, durch Scannen der ARP-Tabelle

• Hersteller identifizieren - Automatische Suche der MAC-Adresse nach Hersteller

• Sicherheitsbedenken markieren - Identifizieren Sie unbekannte oder potenziell riskante Geräte (IoT aus bestimmten Regionen usw.)

• Änderungen verfolgen - Erkennen Sie neue oder entfernte Geräte zwischen den Scans

• Ihr Netzwerk dokumentieren - Exportieren Sie in Markdown für Obsidian oder andere Dokumentationssysteme

Related MCP server: Security MCP Server

Funktionen

Voraussetzungen

• Node.js 18+

• macOS oder Linux (verwendet den arp-Befehl)

• Netzwerkzugriff auf das lokale Subnetz

Installation

Verwendung von npm (Empfohlen)

npx mcp-homescan

Oder global installieren:

npm install -g mcp-homescan

Aus dem Quellcode

git clone https://github.com/aplaceforallmystuff/mcp-homescan.git
cd mcp-homescan
npm install
npm run build

Konfiguration

Für Claude Desktop

Fügen Sie dies Ihrer Claude Desktop-Konfigurationsdatei hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "homescan": {
      "command": "npx",
      "args": ["-y", "mcp-homescan"],
      "env": {
        "HOMESCAN_SUBNET": "192.168.1"
      }
    }
  }
}

Für Claude Code

Fügen Sie dies zu ~/.claude.json hinzu:

{
  "mcpServers": {
    "homescan": {
      "command": "npx",
      "args": ["-y", "mcp-homescan"],
      "env": {
        "HOMESCAN_SUBNET": "192.168.1"
      }
    }
  }
}

Umgebungsvariablen

Anwendungsbeispiele

Netzwerkerkennung

"Scan my home network for devices"

"What devices are on my network?"

"Refresh the network scan and show all devices"

Geräteuntersuchung

"What's the device at 192.168.1.34?"

"Look up the manufacturer for MAC address aa:bb:cc:dd:ee:ff"

Sicherheitsüberprüfung

"Show me any flagged devices on my network"

"Are there any unknown devices I should investigate?"

Änderungsprotokollierung

"Have any new devices appeared since the last scan?"

"Show me what's changed on my network"

Dokumentation

"Export my network inventory to markdown"

"Generate a network report"

Verfügbare Tools

Entwicklung

# Watch mode for development
npm run watch

# Build TypeScript
npm run build

# Run locally
node dist/index.js

Fehlerbehebung

"No devices found"

Stellen Sie sicher, dass Sie sich im selben Netzwerksegment befinden und das Subnetz korrekt konfiguriert ist. Versuchen Sie, den Befehl mit refresh: true auszuführen, um zuerst einen Ping-Sweep durchzuführen.

"Permission denied"-Fehler

Die ARP-Tabelle erfordert auf einigen Systemen möglicherweise erhöhte Berechtigungen. Versuchen Sie bei Bedarf, den Befehl mit sudo auszuführen.

Geräte fehlen beim Scan

Einige Geräte reagieren möglicherweise nicht auf ARP-Anfragen. Verwenden Sie homescan_discover mit refresh: true, um zuerst das Netzwerk per Ping-Sweep zu scannen.

Falsches Subnetz

Überprüfen Sie Ihre Netzwerkkonfiguration und aktualisieren Sie HOMESCAN_SUBNET, damit es mit Ihrem lokalen Netzwerk übereinstimmt (übliche Werte: 192.168.1, 192.168.0, 10.0.0).

Sicherheitshinweise

• Dieses Tool scannt nur Ihr lokales Netzwerk

• Es werden keine Daten extern gesendet

• Markierte Geräte sind nur Empfehlungen — überprüfen Sie diese, bevor Sie Maßnahmen ergreifen

• Siehe SECURITY.md für die Offenlegung von Schwachstellen

Roadmap

Siehe ROADMAP.md für geplante Arbeiten und Umfangsschätzungen.

Mitwirken

Beiträge sind willkommen! Bitte lesen Sie CONTRIBUTING.md für Richtlinien.

Lizenz

MIT - siehe LICENSE für Details.

Links

• Model Context Protocol

• MCP Specification

• GitHub Repository