Bench

Benchは、macOSネイティブのMCPサーバーであり、Claude Code、Cursor、WindsurfなどのAIツールに対して、接続されているUSBハードウェアの可視性を提供します。デバイスの識別、シリアルポートの検索、一般的なメーカーボードの認識を行うため、AIアシスタントがあなたの作業台にあるものを把握できるようになります。

APIキーは不要。ドライバーも不要。コマンド1つでインストール可能です。

機能

4つのカテゴリーにわたる22のツール：

検出 (Discovery)

モニタリング (Monitoring)

管理 (Management)

シリアル通信 (Serial Communication)

Related MCP server: dwf-mcp-server

特徴

• デバイス分類 — デバイスをストレージ、入力、ハブ、ビデオ、シリアルアダプター、マイクロコントローラー、デバッガーとして自動的に分類します

• シリアルポート検出 — USBデバイスをその /dev/cu.* シリアルポートにマッピングします（メーカーが最もよく尋ねる質問です）

• 83種類以上の既知のボード — Arduino、Raspberry Pi、ESP32、Adafruit、SparkFun、Teensy、STM32、および一般的なUSBシリアルチップを認識します

• ストレージ情報 — USBドライブのマウントポイント、容量、空き容量を表示します

• USBモニタリング — イベント追跡、状態スナップショット、診断ログクエリ、電力分析

• ファームウェア書き込み — ESP32、STM32、Arduino AVR、RP2040ボードに直接書き込みます

• HIDインタラクション — Stream Deck、マクロパッド、カスタムHIDデバイスとの間でレポートを送受信します

• シリアル通信 — ボーレート、データビット、パリティ、ストップビットを設定してシリアルポートを開き、読み書きや監視を行います

要件

• macOS 14以降（Sonoma以降）、Apple Silicon搭載機

• MCP互換のAIツール（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": []
    }
  }
}

使用方法

接続したら、AIツールに話しかけるだけです：

• 「接続されているUSBデバイスは何ですか？」

• 「Arduinoはどのポートにありますか？」

• 「/dev/cu.usbserial-2120 にあるデバイスを特定して」

• 「Samsung T7を取り出して」

• 「すべてのストレージデバイスを表示して」

• 「/dev/cu.usbserial-2120 へのシリアル接続を9600ボーで開いて」

• 「ESP32からのシリアル出力を10秒間監視して」

仕組み

Benchは、Appleの IOKit フレームワークを使用して、macOS上でネイティブにUSBデバイスを列挙します。シリアルポート検出（/dev/cu.* スキャン）、ストレージ情報（diskutil）、および既知のメーカーボードの組み込みデータベースを使用して結果を強化します。AIツールとは、Model Context Protocol (JSON-RPC) を使用してstdio経由で通信します。

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

特別な権限は必要ありません。IOKitのUSB列挙は、CLIバイナリからエンタイトルメントなしで動作します。

ビルド

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

BenchはSwift 6.1以降を必要とし、macOS 14以降をターゲットとしています。

ライセンス

MIT

クレジット

Seaynic Labs によって構築されました。