Allows scanning and detecting nearby Bluetooth devices, with the ability to filter devices by name
Bluetooth MCP Server
Model Context Protocol Server for Bluetooth Device Detection
🔍 Overview
This project implements a Model Context Protocol (MCP) server that enables Claude and other AI assistants to scan and interact with Bluetooth devices in your vicinity. Built with a Test-Driven Development approach, it provides a robust, tested interface for Bluetooth operations across multiple platforms.
✨ Features
- 📡 Multi-protocol scanning: Detect both BLE and Classic Bluetooth devices
- 🔎 Flexible filtering: Filter devices by name, type, or other attributes
- 🔄 Automatic device recognition: Identify and categorize common devices (like Freebox, TVs, etc.)
- 📱 Enhanced device information: Get manufacturer info, device type, and detailed characteristics
- 🖥️ Cross-platform support: Works on Windows, macOS, and Linux
- ⚡ Platform-specific optimizations: Enhanced detection capabilities on Windows
- 🤖 MCP Integration: Seamless integration with Claude and compatible AI assistants
📋 Requirements
- Python 3.7+
- Bluetooth adapter (built-in or external)
- Admin/sudo privileges (required for some Bluetooth operations)
- Internet connection (for package installation)
🚀 Quick Start
Installation
Running the Server
Using with Claude
- Expose your server to the internet using ngrok or deploy it to a server:
- Configure Claude to use your MCP server:
- Ask Claude to scan for Bluetooth devices:
🧪 Testing
This project follows a Test-Driven Development (TDD) approach with comprehensive test coverage:
🏗️ Architecture
The project follows a modular architecture with clear separation of concerns:
For detailed architecture information, see architecture.md.
🔧 Troubleshooting
Bluetooth Issues
- "Access denied" errors: Run the server with admin/sudo privileges
- Adapter not detected: Ensure Bluetooth is enabled in your system settings
- No devices found: Make sure there are discoverable Bluetooth devices nearby
- Windows-specific issues: Check that Bluetooth services are active (
services.msc
)
MCP Issues
- Tool not detected by Claude: Verify your MCP server URL is correct and accessible
- Execution errors: Check the server logs for detailed error information
👥 Contributing
Contributions are welcome! Please follow these steps:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature
) - Write tests for your feature
- Implement your feature
- Ensure all tests pass
- Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgements
- FastAPI for the API framework
- Bleak for cross-platform Bluetooth functionality
- Anthropic Claude for MCP integration support
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A ModelContextProtocol server that enables Claude AI to detect and scan nearby Bluetooth devices, providing Bluetooth sensing capabilities to Claude through a compatible MCP interface.
Related MCP Servers
- -securityFlicense-qualityA comprehensive suite of Model Context Protocol servers designed to extend AI agent Claude's capabilities with integrations for knowledge management, reasoning, advanced search, news access, and workspace tools.Last updated 7 months ago5TypeScript
- -securityFlicense-qualityA Model Context Protocol server that allows Claude to make API requests on your behalf, providing tools for testing various APIs including HTTP requests and OpenAI integrations without sharing your API keys in the chat.Last updated 5 months agoPython
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to interact directly with Home Assistant, allowing them to query device states, control smart home entities, and perform automation tasks.Last updated 4 days ago12135PythonMIT License
- -securityFlicense-qualityA Model Context Protocol server that enables Claude AI to interact with PocketBase databases by listing and accessing collections through natural language.Last updated 5 months ago21JavaScript