bluetooth-mcp-server

bluetooth-mcp-server

3
communicationos_automation

This project provides a Model Context Protocol server to enable scanning and interaction with Bluetooth devices across different platforms. It features multi-protocol scanning, flexible filtering, and automatic device recognition, with a focus on integration with AI assistants like Claude.

🔍 Overview

This project implements a Model Context Protocol (MCP) server for detecting and interacting with Bluetooth devices. It is built with a Test-Driven Development approach and integrates seamlessly with Claude and compatible AI assistants to perform Bluetooth operations across multiple platforms.

✨ Features

  • Multi-protocol scanning: Works with both BLE and Classic Bluetooth devices.
  • Flexible filtering: Filter devices by various attributes.
  • Automatic device recognition: Identifies common devices.
  • Enhanced device information: Provides detailed characteristics.
  • Cross-platform support: Compatible with Windows, macOS, and Linux.
  • Platform-specific optimizations: Enhanced capabilities on Windows.
  • MCP Integration: Seamless integration with Claude and similar AI assistants.

📋 Requirements

  • Python 3.7+
  • Bluetooth adapter
  • Admin/sudo privileges for certain operations
  • Internet connection for package installation

🔧 Troubleshooting

  • "Access denied" errors: Run with admin/sudo privileges.
  • Adapter not detected: Ensure Bluetooth is enabled.
  • No devices found: Ensure there are discoverable devices nearby.
  • Windows issues: Verify Bluetooth services are active.

👥 Contributing

  • Fork the repository and create a feature branch.
  • Write tests and implement your feature.
  • Ensure all tests pass and open a Pull Request.

📄 License

This project is licensed under the MIT License.