Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • MindManager MCP Server
  • TMDB MCP Server
  • iTerm MCP Server
  • Cryptocurrency Daemon MCP Server
  • Xano MCP Server
Back to MCP Servers
Bluetooth MCP Server

Bluetooth MCP Server

Public
Hypijump31/bluetooth-mcp-server

Enables AI assistants to detect, filter, and interact with BLE and Classic Bluetooth devices across Windows, macOS, and Linux via a robust Model Context Protocol interface with enhanced device recognition and detailed information.

python
0 tools
May 29, 2025
Updated Jun 4, 2025

Supercharge Your AI with Bluetooth MCP Server

MCP Server

Unlock the full potential of Bluetooth MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available โ€ข No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

Bluetooth MCP Server

Bluetooth Logo

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

# Clone the repository git clone https://github.com/yourusername/bluetooth-mcp-server.git cd bluetooth-mcp-server # Create and activate virtual environment python -m venv venv # On Windows venv\Scripts\activate # On macOS/Linux source venv/bin/activate # Install dependencies pip install -r requirements.txt # Configure environment variables cp .env.example .env # Edit the .env file as needed

Running the Server

# Start the Bluetooth API server python run.py # In another terminal, start the MCP server python bluetooth_mcp_server.py

Using with Claude

  1. Expose your server to the internet using ngrok or deploy it to a server:

    ngrok http 8000
  2. Configure Claude to use your MCP server:

    npx @anthropic-ai/sdk install-model-context-protocol
  3. Ask Claude to scan for Bluetooth devices:

    Could you scan for nearby Bluetooth devices?
    

๐Ÿงช Testing

This project follows a Test-Driven Development (TDD) approach with comprehensive test coverage:

# Run all tests pytest # Run specific test categories pytest tests/api/ # API tests pytest tests/models/ # Data model tests pytest tests/services/ # Service logic tests pytest tests/utils/ # Utility function tests

๐Ÿ—๏ธ Architecture

The project follows a modular architecture with clear separation of concerns:

bluetooth-mcp-server/
โ”œโ”€โ”€ app/                # Main application package
โ”‚   โ”œโ”€โ”€ api/            # FastAPI endpoints
โ”‚   โ”œโ”€โ”€ core/           # Core configuration
โ”‚   โ”œโ”€โ”€ data/           # Static data (Bluetooth identifiers, etc.)
โ”‚   โ”œโ”€โ”€ models/         # Data models
โ”‚   โ”œโ”€โ”€ services/       # Business logic
โ”‚   โ””โ”€โ”€ utils/          # Utility functions
โ”œโ”€โ”€ mcp_sdk/            # MCP integration SDK
โ””โ”€โ”€ tests/              # Test suites

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:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Write tests for your feature
  4. Implement your feature
  5. Ensure all tests pass
  6. Commit your changes (git commit -m 'Add amazing feature')
  7. Push to the branch (git push origin feature/amazing-feature)
  8. 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
Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • MindManager MCP Server
    MindManager MCP Server

    Enables programmatic interaction with MindManager on Windows and macOS via the Model Context Protoco...

    9 tools
    Added May 30, 2025
  • TMDB MCP Server
    TMDB MCP Server

    Provides AI assistants with seamless access to The Movie Database API via Model Context Protocol, en...

    Added May 30, 2025
  • iTerm MCP Server
    iTerm MCP Server

    Enables AI assistants to manage and interact with iTerm2 terminal sessions on macOS via the Model Co...

    Added May 30, 2025
  • Cryptocurrency Daemon MCP Server
    Cryptocurrency Daemon MCP Server

    Enables AI assistants to securely interact with cryptocurrency daemon RPC interfaces for managing wa...

    Added May 30, 2025
  • Xano MCP Server
    Xano MCP Server

    Python-based Model Context Protocol server enabling AI assistants to securely interact with Xano ins...

    Added May 30, 2025