MCP Homescan Server

Сервер MCP для обнаружения устройств в домашней сети и сканирования безопасности. Находит устройства в вашей локальной сети, определяет производителей, помечает потенциальные угрозы безопасности и экспортирует данные в формат инвентаризации Obsidian.

Зачем это нужно?

Если вы управляете домашней сетью или сетью малого офиса, этот сервер MCP позволяет вам:

• Обнаружить все устройства — найти всё, что подключено к вашей сети, с помощью сканирования ARP-таблицы

• Идентифицировать производителей — автоматический поиск производителя по MAC-адресу

• Отметить угрозы безопасности — выявить неизвестные или потенциально рискованные устройства (IoT из определенных регионов и т. д.)

• Отслеживать изменения — обнаруживать новые или удаленные устройства между сканированиями

• Документировать сеть — экспортировать данные в Markdown для Obsidian или других систем документации

Related MCP server: Security MCP Server

Возможности

Предварительные требования

• Node.js 18+

• macOS или Linux (использует команду arp)

• Сетевой доступ к локальной подсети

Установка

Использование npm (рекомендуется)

npx mcp-homescan

Или установите глобально:

npm install -g mcp-homescan

Из исходного кода

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

Конфигурация

Для Claude Desktop

Добавьте в файл конфигурации Claude Desktop:

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"
      }
    }
  }
}

Для Claude Code

Добавьте в ~/.claude.json:

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

Переменные окружения

Примеры использования

Обнаружение сети

"Scan my home network for devices"

"What devices are on my network?"

"Refresh the network scan and show all devices"

Исследование устройств

"What's the device at 192.168.1.34?"

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

Проверка безопасности

"Show me any flagged devices on my network"

"Are there any unknown devices I should investigate?"

Отслеживание изменений

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

"Show me what's changed on my network"

Документирование

"Export my network inventory to markdown"

"Generate a network report"

Доступные инструменты

Разработка

# Watch mode for development
npm run watch

# Build TypeScript
npm run build

# Run locally
node dist/index.js

Устранение неполадок

"No devices found"

Убедитесь, что вы находитесь в том же сегменте сети и подсеть настроена правильно. Попробуйте запустить с refresh: true, чтобы сначала выполнить ping-sweep.

Ошибки "Permission denied"

ARP-таблица может требовать повышенных привилегий в некоторых системах. Попробуйте запустить с sudo, если это необходимо.

Устройства отсутствуют в результатах сканирования

Некоторые устройства могут не отвечать на ARP-запросы. Используйте homescan_discover с refresh: true, чтобы сначала выполнить ping-sweep сети.

Неверная подсеть

Проверьте настройки сети и обновите HOMESCAN_SUBNET в соответствии с вашей локальной сетью (обычные значения: 192.168.1, 192.168.0, 10.0.0).

Примечания по безопасности

• Этот инструмент сканирует только вашу локальную сеть

• Данные не отправляются вовне

• Помеченные устройства являются лишь рекомендациями — проверяйте их перед принятием мер

• См. SECURITY.md для раскрытия информации об уязвимостях

Дорожная карта

См. ROADMAP.md для планируемых работ и оценки объема.

Участие в разработке

Вклад приветствуется! Пожалуйста, ознакомьтесь с CONTRIBUTING.md для получения рекомендаций.

Лицензия

MIT — подробности см. в LICENSE.

Ссылки

• Model Context Protocol

• Спецификация MCP

• Репозиторий GitHub