# Devices Mcp

> Beta: MCP server + web dashboard + Windows Tauri app for home LAN devices (Tapo, Hue, Ring, Nest, Shelly).

- **Type:** MCP server
- **Install:** `agentstack add mcp-sandraschi-devices-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sandraschi](https://agentstack.voostack.com/s/sandraschi)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [sandraschi](https://github.com/sandraschi)
- **Source:** https://github.com/sandraschi/devices-mcp

## Install

```sh
agentstack add mcp-sandraschi-devices-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# devices-mcp

**Beta** home IoT stack for Sandra's fleet: **MCP tools** for agents, a **web dashboard** for humans, and an optional **Windows desktop installer** that bundles both. LAN devices (Tapo cameras/plugs, Philips Hue, Ring, Nest via Home Assistant, Shelly, USB cams, Netatmo, Vienna presets) are configured in `config.yaml` — not shipped as secrets.

> Not production-hardened. Expect rough edges, slow cold starts (~2 min for full PyInstaller sidecars), and API changes between releases.

---

## Table of contents

| Section | Link |
|--------|------|
| Three delivery legs | [Three legs](#three-delivery-legs) |
| Features (realistic) | [Features](#features) |
| Quick install | [Quick install](#quick-install) |
| Documentation | [Documentation](#documentation) |
| Ports | [Ports](#ports) |
| Requirements | [Requirements](#requirements) |
| License | [License](#license) |

---

## Three delivery legs

| Leg | What you get | Best for |
|-----|----------------|----------|
| **1 — MCP server** | FastMCP stdio/HTTP, 40+ portmanteau tools | Claude Desktop, Cursor, automation |
| **2 — Webapp** | Vite/React UI + FastAPI (`web-sota/`) | Browser dashboard, same APIs as desktop |
| **3 — Desktop (Tauri)** | `Devices-MCP-*-setup.exe` (~247 MB) | Double-click Windows install; spawns camera + backend sidecars |

Use **one backend on port 10717** at a time. If you already run the stack via **NSSM** or `just serve`, open the dashboard in a browser — do not start a second backend from the desktop app.

Details: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) · Desktop: [docs/DESKTOP.md](docs/DESKTOP.md)

---

## Features

- **Cameras:** Tapo/ONVIF, USB webcam/microscope (OpenCV), streaming hooks (quality varies by device/driver).
- **Energy:** Tapo P115 plugs; LAN discovery optional when cloud creds are set.
- **Lighting:** Philips Hue (incl. HomeAware on supported bridges), Tapo lighting.
- **Security / sensors:** Ring, Nest Protect via Home Assistant, Shelly, Netatmo, Open-Meteo (Vienna default).
- **Dashboard:** Status table with device health, per-domain pages (cameras, energy, weather, robots, …).
- **MCP:** Portmanteau tools (camera, energy, lighting, ring, nest, weather, …) on FastMCP 3.2.
- **Fleet priority:** `GET /api/fleet/priority` — home-safety incidents for Fritz urgent dispatch (kitchen temp, CO, smoke, Ring).

**Not included:** guaranteed uptime SLA, cloud hosting, plug-and-play without `config.yaml`, or a single 12 MB exe (full desktop bundle is ~247 MB with embedded Python sidecars).

---

## Quick install

**Windows desktop (leg 3):** [GitHub Releases](https://github.com/sandraschi/devices-mcp/releases) → `Devices MCP_*_x64-setup.exe` (single NSIS installer — that's all you need).

**MCP bundle (leg 1):** Releases → `devices-mcp.mcpb` → Claude Desktop.

**Developers (leg 1+2):** see [INSTALL.md](INSTALL.md).

```powershell
git clone https://github.com/sandraschi/devices-mcp
cd devices-mcp
uv sync
.\web-sota\start.ps1
# http://127.0.0.1:10717/app/
```

## Build & Test (NSIS installer)

The desktop installer bundles TWO sidecars (backend + camera helper) into a single `Devices MCP_*_x64-setup.exe` (~247 MB).

```powershell
just build-native      # Full pipeline: frontend → PyInstaller → Rust → NSIS
just cua-nsis-test     # Install → CUA test → screenshot → uninstall
```

The **CUA smoke test** (`scripts/cua-smoke.py`) verifies:
1. Silent install succeeds
2. Backend health responds 200 on port 10717
3. Window renders at correct size
4. Diagnostics endpoint reports all systems
5. Clean uninstall

> See [CUA-NSIS Smoke Testing](https://github.com/sandraschi/mcp-central-docs/blob/main/standards/rules/cua_nsis_smoke_testing.md) — fleet standard.

Prerequisites: Rust toolchain, MSVC Build Tools, Tauri CLI 2.x.

---

## Documentation

| Doc | Contents |
|-----|----------|
| [INSTALL.md](INSTALL.md) | All install paths (Tauri, MCPB, clone, NSSM) |
| [docs/README.md](docs/README.md) | Full documentation index |
| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | MCP + webapp + desktop, ports, sidecars |
| [docs/DESKTOP.md](docs/DESKTOP.md) | Tauri installer, splash, NSSM coexistence |
| [docs/CONFIGURATION.md](docs/CONFIGURATION.md) | `config.yaml`, Vienna preset, discovery flags |
| [docs/TOOLS.md](docs/TOOLS.md) | MCP tool families (summary) |
| [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) | `just`, build scripts, contributing |
| [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) | White screen, logs path, firewall |
| [docs/FLEET_INTEGRATION.md](docs/FLEET_INTEGRATION.md) | Fritz `/api/fleet/priority` consumer contract |
| [CHANGELOG.md](CHANGELOG.md) | Version history |

LLM index: [llms.txt](llms.txt) · full: [llms-full.txt](llms-full.txt)

---

## Ports

| Port | Service |
|------|---------|
| 10717 | FastAPI backend (API + `/app/` SPA) |
| 10716 | Vite dev frontend only |
| 10715 | USB camera helper (optional) |

---

## Requirements

- **OS:** Windows 10/11 x64 for desktop installer; dev backend also runs on Linux/macOS with reduced hardware support.
- **Config:** `config.yaml` with your LAN IPs and credentials (see `config.example.yaml`, `home_preset: vienna` template).
- **Network:** Devices on reachable LAN; mDNS/LAN broadcast for Tapo discovery optional.

---

## License

MIT — see [LICENSE](LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sandraschi](https://github.com/sandraschi)
- **Source:** [sandraschi/devices-mcp](https://github.com/sandraschi/devices-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-sandraschi-devices-mcp
- Seller: https://agentstack.voostack.com/s/sandraschi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.