OpenDeviceDB

OpenDeviceDB — официальный MCP-сервер от opendevicedb. Проверка более 21 000 устройств с открытой прошивкой или протоколами перед реверс-инжинирингом. Лицензия AGPL-3.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
opendevicedb
Лицензия
AGPL-3.0
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: high

Пишет YAML-записи устройств в локальный клон OpenDeviceDB; git не запускает.

Настройка клиентов

codex
{
    "code": "[mcp_servers.opendevicedb]\ncommand = \"node\"\nargs = [\"/path/to/opendevicedb/packages/mcp/src/server.ts\"]\nenv = { ODB_REPO = \"/path/to/opendevicedb\" }",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "verified": "docs"
}

Что умеет

@opendevicedb/mcp — MCP-сервер, через который ИИ-агенты (Claude Code, Codex, Cursor и другие) спрашивают базу OpenDeviceDB до начала реверс-инжиниринга устройства — «это уже сделано? кто-то этим занимается?» — и записывают результаты своей работы после. Работает по stdio на официальном SDK протокола.

Инструменты:

  • lookup_device — проверка одного устройства по идентификатору, производителю и модели, FCC ID, USB vid:pid, имени BLE или модели Zigbee: полная запись, текущий статус, активные заявки и рекомендация в одну строку; явно сообщает, если ничего не известно;
  • search_devices — ранжированный поиск по названиям, псевдонимам и идентификаторам с фильтром по категории и статусу;
  • claim_device — заявка «я работаю над этим устройством» сроком до 90 дней (по умолчанию 30); при необходимости создаёт заготовку записи;
  • publish_findings — слияние результатов с записью: проверка схемы, статус может только расти, есть фильтр по правилам проекта;
  • request_device — если пользователь хочет устройство, но не будет его исследовать: существующий запрос, к которому можно добавить голос, или готовая ссылка на новую задачу GitHub, которую пользователь отправит сам (сервер ничего не публикует);
  • list_sources — импортированные базы с лицензией, датой снимка и числом записей.

Инструменты поиска компонентов (search_components, get_component, validate_composition и другие) работают только на чтение, не запускают чужой код и не обращаются к оборудованию.

Способы установки прошивки. Запись может содержать способы поставить открытую прошивку: метод (web-serial, OTA-эксплойт, USB-загрузчик, сопряжение), официальную инструкцию и установщик, сложность, инструменты, риск «окирпичивания» и обратимость. Рекомендация советует вести пользователя по самому простому способу с официальной инструкцией и никогда не расписывать шаги, если нужно вскрывать устройство с питанием от сети. Сам сервер ничего не прошивает.

Кому подойдёт

Энтузиастам открытого оборудования и исследователям протоколов умных устройств, дронов и игрушек. Похожие серверы — в категории автоматизация.

Установка

Нужны Node.js 22.18+ (исходники на TypeScript запускаются напрямую, без сборки) и клон репозитория OpenDeviceDB с выполненным npm install в корне. Переменная ODB_REPO указывает на локальный клон и разрешает запись; ODB_API_URL включает режим только чтения через статический API сайта с кэшем на 10 минут.

Рабочий процесс агента: найти устройство, оформить заявку, исследовать, опубликовать результаты и открыть пул-реквест. Правила проекта запрещают трогать Remote ID, геозоны и другие функции безопасности, а также копировать прошивки и код производителя.

Подключение к клиентам

Конфиги приведены дословно из README; замените /path/to/opendevicedb на путь к своему клону. Подробнее — в инструкции как подключить MCP.

claude mcp add opendevicedb -e ODB_REPO=/path/to/opendevicedb -- node /path/to/opendevicedb/packages/mcp/src/server.ts

Для Claude Code флаг --scope user подключает сервер во всех проектах. Для Codex блок кладут в ~/.codex/config.toml, для Cursor — в .cursor/mcp.json или ~/.cursor/mcp.json.

Проверка

Спросите: «Есть ли в OpenDeviceDB данные об устройстве с USB 2ca3:001f?»

Примеры задач

Найди в OpenDeviceDB дроны, для которых уже есть открытая прошивка.
Оформи заявку на исследование BLE-протокола игрушки Acme X1 на 30 дней.

Риски

  • Запись файлов. В режиме ODB_REPO сервер пишет YAML-файлы в data/devices/ локального клона. Git он сам не запускает, а только подсказывает команды для коммита и пул-реквеста.
  • Опасные инструкции. Способы прошивки содержат риск повреждения устройства — сверяйтесь с официальными руководствами.
  • Код распространяется по AGPL-3.0-or-later, файл SKILL.md — по CC0-1.0.

Частые вопросы

Можно ли пользоваться без клона репозитория?

Да, в режиме только чтения через ODB_API_URL.

Публикует ли сервер что-то на GitHub?

Нет, он только готовит ссылки и подсказывает команды.

Прошивает ли он устройства?

Нет, только хранит сведения о способах прошивки.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

mcp

Поиск уязвимостей в коде с помощью Semgrep.

Риск: medium Лицензия: LGPL-2.1 ★ 17 617

ida-pro-mcp

Плагин IDA Pro для анализа бинарников: декомпиляция, дизассемблирование и отчёты.

Риск: medium Лицензия: MIT ★ 13 382

GhidraMCP

Реверс-инжиниринг в Ghidra: декомпиляция, переименование методов и списки классов и импортов.

Риск: high Лицензия: Apache-2.0 ★ 11 898

jshookmcp

Реверс-инжиниринг JavaScript: более 700 инструментов.

Риск: medium Лицензия: AGPL-3.0 ★ 2 105

Источники