home / mcp / mcp homescan server

MCP Homescan Server

MCP server for home network discovery and security scanning; discovers devices, identifies manufacturers, flags risks, and exports inventories.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You are running an MCP server designed to discover devices on your local network, identify their manufacturers, flag potential security concerns, and export the results for documentation. It helps you monitor a home or small office network by providing a clear inventory of connected devices and tracking changes over time.

How to use

You interact with the Homescan MCP server through your MCP client. Start a scan to discover all devices on your local network, then review device details, manufacturers, and any flagged items. Use the export options to generate markdown or JSON inventories suitable for Obsidian or other documentation workflows. You can also compare scans to see what has changed and generate a full network report.

How to install

Prerequisites you need on your system are listed below. Make sure you have these before proceeding.

1) Node.js 18 or newer installed on macOS or Linux.

2) Access to your local subnet for network discovery (e.g., 192.168.1.0/24). This tool uses ARP and optional ping sweeps to discover devices.

Add the Homescan MCP server to your MCP client configuration

Use the following steps to configure your MCP client to run the Homescan MCP server as a local (stdio) process.

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

Configuration and environment variables

Environment variables enable you to tailor the scan and lookups.

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

Usage patterns

- Scan my home network for devices to build your inventory.

- Refresh the network scan to detect new or removed devices.

Available tools

homescan_discover

Discover all devices on the local network using ARP table scanning and optional ping sweep.

homescan_device

Get details for a specific device by IP address.

homescan_mac_lookup

Look up the manufacturer from a given MAC address.

homescan_report

Generate a comprehensive network discovery report.

homescan_export

Export the device inventory to markdown or JSON formats.

homescan_diff

Compare the current scan to a previous one and show changes.

homescan_flagged

List devices flagged for security review based on unknown or risky criteria.