Servidor MCP Homescan

Servidor MCP para el descubrimiento de redes domésticas y escaneo de seguridad. Descubre dispositivos en tu red local, identifica fabricantes, señala posibles problemas de seguridad y exporta al formato de inventario de Obsidian.

¿Por qué usar esto?

Si administras una red doméstica o de oficina pequeña, este servidor MCP te permite:

• Descubrir todos los dispositivos - Encuentra todo lo conectado a tu red mediante el escaneo de la tabla ARP

• Identificar fabricantes - Búsqueda automática de fabricante a partir de la dirección MAC

• Señalar problemas de seguridad - Identificar dispositivos desconocidos o potencialmente riesgosos (IoT de ciertas regiones, etc.)

• Rastrear cambios - Detectar dispositivos nuevos o eliminados entre escaneos

• Documentar tu red - Exportar a markdown para Obsidian u otros sistemas de documentación

Related MCP server: Security MCP Server

Características

Requisitos previos

• Node.js 18+

• macOS o Linux (utiliza el comando arp)

• Acceso de red a la subred local

Instalación

Usando npm (Recomendado)

npx mcp-homescan

O instalar globalmente:

npm install -g mcp-homescan

Desde el código fuente

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

Configuración

Para Claude Desktop

Añade al archivo de configuración de 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"
      }
    }
  }
}

Para Claude Code

Añade a ~/.claude.json:

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

Variables de entorno

Ejemplos de uso

Descubrimiento de red

"Escanea mi red doméstica en busca de dispositivos"

"¿Qué dispositivos hay en mi red?"

"Actualiza el escaneo de red y muestra todos los dispositivos"

Investigación de dispositivos

"¿Qué es el dispositivo en 192.168.1.34?"

"Busca el fabricante para la dirección MAC aa:bb:cc:dd:ee:ff"

Revisión de seguridad

"Muéstrame cualquier dispositivo marcado en mi red"

"¿Hay algún dispositivo desconocido que deba investigar?"

Seguimiento de cambios

"¿Han aparecido nuevos dispositivos desde el último escaneo?"

"Muéstrame qué ha cambiado en mi red"

Documentación

"Exporta mi inventario de red a markdown"

"Genera un informe de red"

Herramientas disponibles

Desarrollo

# Watch mode for development
npm run watch

# Build TypeScript
npm run build

# Run locally
node dist/index.js

Solución de problemas

"No devices found"

Asegúrate de estar en el mismo segmento de red y que la subred esté configurada correctamente. Intenta ejecutar con refresh: true para realizar primero un barrido de ping.

Errores de "Permission denied"

La tabla ARP puede requerir permisos elevados en algunos sistemas. Intenta ejecutar con sudo si es necesario.

Dispositivos que faltan en el escaneo

Algunos dispositivos pueden no responder a las consultas ARP. Usa homescan_discover con refresh: true para hacer un barrido de ping a la red primero.

Subred incorrecta

Verifica la configuración de tu red y actualiza HOMESCAN_SUBNET para que coincida con tu red local (valores comunes: 192.168.1, 192.168.0, 10.0.0).

Notas de seguridad

• Esta herramienta solo escanea tu red local

• No se envían datos externamente

• Los dispositivos marcados son solo recomendaciones: verifica antes de tomar medidas

• Consulta SECURITY.md para la divulgación de vulnerabilidades

Hoja de ruta

Consulta ROADMAP.md para el trabajo planificado y las estimaciones de alcance.

Contribución

¡Las contribuciones son bienvenidas! Consulta CONTRIBUTING.md para conocer las pautas.

Licencia

MIT - consulta LICENSE para más detalles.

Enlaces

• Model Context Protocol

• Especificación MCP

• Repositorio de GitHub