simpleaible

Use the SimpleAIBLE MCP server to scan, connect, and interact with Bluetooth devices. This skill provides guidance on the recommended flow (scan -u003e connect -u003e services -u003e read/notify) and handles platform-specific differences like UUIDs on macOS vs MAC addresses on Linux. Use when the user wants to interact with BLE hardware or debug Bluetooth connections.

1. Zainstaluj skill SimpleAIBLE jako serwer MCP w swoim środowisku Claude lub Copilot, wskazując repozytorium https://github.com/simpleble/simpleble/tree/main/simpleaible/skills/simpleaible.

2. Rozpocznij od skanowania dostępnych urządzeń BLE, wywołując polecenie scan_for (domyślnie skanuje przez 5 sekund). Otrzymasz listę urządzeń w zasięgu wraz z ich adresami — na macOS będą to UUID, na Linuksie adresy MAC.

3. Wybierz urządzenie z wyników skanowania i nawiąż połączenie, używając polecenia connect z adresem uzyskanym w poprzednim kroku.

4. Po połączeniu wywołaj polecenie services, aby wyświetlić dostępne usługi GATT i charakterystyki urządzenia. To pozwoli Ci zrozumieć, jakie dane można odczytać lub na jakie można wysyłać polecenia.

5. W zależności od potrzeb: użyj read do jednorazowego odczytania wartości, write_request lub write_command do wysłania danych, albo notify/indicate do subskrypcji na dane przesyłane w czasie rzeczywistym. Dane binarne otrzymasz zawsze w formacie data_hex (niezawodny) i data_utf8 (czytelny dla człowieka, jeśli dane są tekstem).

6. Po zakończeniu pracy zawsze wywołaj disconnect, aby zwolnić urządzenie i zamknąć połączenie.