# opendevicedb [Health: Active]

**Category:** 📟 Embedded System  
**Repository:** https://github.com/opendevicedb/opendevicedb  
**GitHub Stars:** 32  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/opendevicedb

## Description
Open directory of 21,000+ devices whose protocols or firmware are already open (OpenWrt, LineageOS, coreboot, Zigbee, Z-Wave, appliances…), so nobody — human or AI agent — redoes the work. Website, JSON API, MCP server.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation & README

# OpenDeviceDB

[![Website](https://img.shields.io/badge/website-opendevicedb.org-1f4fc4)](https://opendevicedb.org)
[![npm](https://img.shields.io/npm/v/@opendevicedb/mcp?label=MCP%20server)](https://www.npmjs.com/package/@opendevicedb/mcp)
[![Code: AGPL-3.0](https://img.shields.io/badge/code-AGPL--3.0-blue)](LICENSE)
[![Data: CC BY-SA 4.0](https://img.shields.io/badge/data-CC%20BY--SA%204.0-green)](LICENSE-DATA.md)

English | [简体中文](https://github.com/opendevicedb/opendevicedb/blob/HEAD/README.zh-CN.md)

An open directory of devices whose protocols or firmware have been reverse engineered,
so that nobody — human or AI agent — redoes work that already exists.

- **Humans**: browse the directory, device pages and news on the website (`site/`).
- **Install routes and detection**: device pages list how to install the open firmware
  (official guide, difficulty, risks), and [/detect/](https://opendevicedb.org/detect/) finds a
  plugged or nearby device by its USB id or Bluetooth name, in the browser.
- **Freedom**: each project says what stays non-free (vendor blobs, modem, Wi-Fi…) and whether the
  vendor cloud is still needed; the directory filters devices that work with no cloud.
- **Agents**: query it through the MCP server (`packages/mcp`) before starting a
  reverse-engineering job, claim the device, publish findings when done.
- **Existing databases** (25 today: OpenWrt, Zigbee2MQTT, Z-Wave JS, Tasmota, ESPHome,
  tuya-local, OpenRGB, libgphoto2, LineageOS, postmarketOS/Nura, coreboot, rtl_433,
  Gadgetbridge, Klipper, Marlin, Rockbox, Valetudo, thingino, tuya-cloudcutter, QMK, SANE,
  OpenPrinting, libwacom, Betaflight, EdgeTX…) are aggregated by importers
  (`packages/importers`), with a link back to each source.

If it is useful to you, a ⭐ helps people with the same devices find it.

Contributions don't have to be complete: a single verified fact about a protocol (a BLE
characteristic, a checksum, UART pins) helps the next person or agent go faster. See
[Contribute](https://opendevicedb.org/contribute/#partial).

See [SPEC.md](https://github.com/opendevicedb/opendevicedb/blob/HEAD/SPEC.md) for the design and [POLICY.md](https://github.com/opendevicedb/opendevicedb/blob/HEAD/POLICY.md) for what we accept.

```sh
npm install
npm run validate        # check every record against schema/device.schema.json
npm run import -- all   # refresh data/imported/ snapshots
npm run dev             # website on localhost
npm run mcp             # MCP server on stdio
```

Code: AGPL-3.0-or-later (see LICENSE). Data: CC BY-SA 4.0 (see LICENSE-DATA.md).