Bench

Bench — это нативный macOS MCP-сервер, который предоставляет ИИ-инструментам, таким как Claude Code, Cursor и Windsurf, возможность видеть подключенное USB-оборудование. Он идентифицирует устройства, находит последовательные порты и распознает популярные платы для разработчиков — чтобы ваш ИИ-ассистент знал, что находится на вашем рабочем столе.

Никаких API-ключей. Никаких драйверов. Установка одной командой.

Что он делает

22 инструмента в четырех категориях:

Обнаружение

Мониторинг

Управление

Последовательная связь

Related MCP server: dwf-mcp-server

Возможности

• Классификация устройств — автоматическая категоризация устройств как накопители, устройства ввода, концентраторы, видео, последовательные адаптеры, микроконтроллеры или отладчики

• Обнаружение последовательных портов — сопоставление USB-устройств с их последовательными портами /dev/cu.* (самый частый вопрос мейкеров)

• 83+ известных плат — распознавание Arduino, Raspberry Pi, ESP32, Adafruit, SparkFun, Teensy, STM32 и распространенных USB-serial чипов

• Информация о накопителях — точки монтирования, емкость и свободное место на USB-дисках

• USB-мониторинг — отслеживание событий, снимки состояния, запросы диагностических логов и анализ питания

• Прошивка — прямая прошивка плат ESP32, STM32, Arduino AVR и RP2040

• HID-взаимодействие — отправка и получение отчетов от Stream Deck, макро-падов и пользовательских HID-устройств

• Последовательная связь — открытие, чтение, запись и мониторинг последовательных портов с настраиваемой скоростью, битами данных, четностью и стоповыми битами

Требования

• macOS 14+ (Sonoma или новее) на Apple Silicon

• MCP-совместимый ИИ-инструмент (Claude Code, Cursor, Windsurf и т.д.)

• Для сборки из исходного кода: Xcode 16.3+ / Swift 6.1+

Установка

Homebrew (рекомендуется)

brew install seayniclabs/tap/bench

Из исходного кода

git clone https://github.com/seayniclabs/bench.git
cd bench
swift build -c release
codesign --force --sign - --entitlements Sources/Bench/Bench.entitlements .build/release/Bench

Бинарный файл находится в .build/release/Bench.

Добавление в Claude Code

claude mcp add bench -- $(which bench)

Или добавьте вручную в ~/.claude.json:

{
  "mcpServers": {
    "bench": {
      "command": "/path/to/bench",
      "args": []
    }
  }
}

Использование

После подключения просто поговорите со своим ИИ-инструментом:

• "Какие USB-устройства подключены?"

• "На каком порту находится мой Arduino?"

• "Идентифицируй устройство на /dev/cu.usbserial-2120"

• "Извлеки Samsung T7"

• "Покажи мне все устройства хранения"

• "Открой последовательное соединение с /dev/cu.usbserial-2120 на скорости 9600 бод"

• "Мониторь последовательный вывод с моего ESP32 в течение 10 секунд"

Как это работает

Bench использует фреймворк Apple IOKit для нативного перечисления USB-устройств в macOS. Он дополняет результаты обнаружением последовательных портов (сканирование /dev/cu.*), информацией о накопителях (diskutil) и встроенной базой данных известных плат для разработчиков. Он взаимодействует с ИИ-инструментами через stdio, используя Model Context Protocol (JSON-RPC).

AI Tool  --stdio/JSON-RPC-->  Bench  --IOKit-->  USB Device Tree
                                     --diskutil-->  Storage Info
                                     --/dev/cu.*-->  Serial Ports
                                     --DeviceDB-->  Board Recognition

Никаких специальных разрешений не требуется. Перечисление USB через IOKit работает без прав доступа для CLI-бинарного файла.

Сборка

swift build             # debug build
swift build -c release  # release build
swift test              # run tests

Bench требует Swift 6.1+ и предназначен для macOS 14+.

Лицензия

MIT

Авторы

Создано Seaynic Labs.