Device Scanner MCP

An MCP (Model Context Protocol) server that detects WiFi, Ethernet, and USB devices — and lets you SSH into them, deploy files, run tests, and manage services, all through Claude Code.

Works with any company/product — all config lives in .env.

Features

• 23 tools covering scanning, SSH, SCP, deployment, testing, health checks, logs, services, and more
• WiFi-hop: auto-switches WiFi to a device (no internet), runs commands, switches back
• Ethernet/USB: direct SSH — no hopping needed
• Multi-device: run commands across multiple devices in one call
• GTest parser: structured pass/fail results from test binaries
• Zero hardcoded secrets — everything in .env

Quick Install

For Claude Code users

claude mcp add device-scanner -- uvx device-scanner-mcp

Or with pip:

pip install device-scanner-mcp
claude mcp add device-scanner -- python -m device_scanner_mcp

Setup

1. Create a .env file in your working directory (copy from .env.example):

COMPANY_NAME=MyCompany
OFFICE_SSIDS=Office-WiFi,Guest-WiFi
DEVICE_PREFIXES=MYDEVICE_,SENSOR_
DEVICE_MYDEVICE=192.168.4.1,192.168.5.1,,root,password
DEVICE_ALIASES=Robot:MYDEVICE

2. Run Claude Code and start using the tools.

Tools

Scanning

Direct SSH/SCP (Ethernet & USB)

WiFi Hop (auto switches WiFi back and forth)

Device Management

WiFi Management

.env Configuration

See .env.example for full documentation. Key settings:

# Company
COMPANY_NAME=MyCompany

# Office WiFi (with internet)
OFFICE_SSIDS=Office-5G,Guest-WiFi

# Device SSID prefixes (no internet)
DEVICE_PREFIXES=ROBOT_,SENSOR_

# Device profiles: wifi_ip,eth_ip,usb_ip,user,password
DEVICE_ROBOT=192.168.4.1,192.168.5.1,192.168.6.1,root,password

# Aliases: product_name:ssid_prefix
DEVICE_ALIASES=MainRobot:ROBOT

License

MIT