Bluetooth MCP Server

Bluetooth MCP Server

MCP server enabling Claude and AI assistants to scan and interact with nearby Bluetooth devices.

16
Stars
4
Forks
0
Releases

Overview

This MCP server delivers a Model Context Protocol interface for Bluetooth device detection and interaction. Built with a test-driven approach, it provides a robust, extensible API to discover, identify, and query nearby Bluetooth devices across platforms. It supports multi-protocol scanning (BLE and Classic Bluetooth), enabling flexible filtering by name, type, or other attributes. The server automatically recognizes common devices and categorizes them, and enriches results with manufacturer information, device type, and detailed characteristics. It is cross-platform, running on Windows, macOS, and Linux, with platform-specific optimizations for Windows. The architecture is modular (app core, data, models, services, utils) and integrates with the MCP SDK to expose device discovery and control to Claude and compatible AI assistants. The project follows a Test-Driven Development workflow, with comprehensive tests and clear separation of concerns. It requires Python 3.7+, a Bluetooth adapter, admin privileges for certain operations, and internet access for packaging. It uses Bleak for Bluetooth operations and FastAPI for API endpoints.

Details

Owner
Hypijump31
Language
Python
License
MIT License
Updated
2025-12-07

Features

Multi-protocol scanning

Supports scanning for both BLE and Classic Bluetooth devices, enabling broad device coverage.

Flexible filtering

Allows filtering results by name, type, or custom attributes to focus on relevant devices.

Automatic device recognition

Automatically recognizes and categorizes common devices (e.g., Freebox, TVs) to streamline discovery.

Enhanced device information

Provides rich device metadata including manufacturer, device type, and detailed characteristics.

Cross-platform support

Ensures compatibility across Windows, macOS, and Linux platforms.

Platform-specific optimizations

Includes Windows-specific optimizations to improve detection and reliability.

MCP Integration

Exposes MCP endpoints for seamless integration with Claude and compatible AI assistants.

Audience

AI developersEnables Claude and compatible AI assistants to scan, discover, and manage nearby Bluetooth devices.

Tags

BluetoothMCPBLEClassic BluetoothDevice discoveryCross-platformClaudeAI assistantsBleakFastAPIWindowsmacOSLinux