Servidor MCP Bluetooth

Servidor de protocolo de contexto de modelo para la detección de dispositivos Bluetooth

🔍 Descripción general

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) que permite a Claude y a otros asistentes de IA escanear e interactuar con dispositivos Bluetooth cercanos. Desarrollado con un enfoque de desarrollo basado en pruebas, proporciona una interfaz robusta y probada para operaciones Bluetooth en múltiples plataformas.

Related MCP server: my-mcp-server

✨ Características

• 📡 Escaneo multiprotocolo : detecta dispositivos BLE y Bluetooth clásico

• 🔎 Filtrado flexible : filtre dispositivos por nombre, tipo u otros atributos

• 🔄 Reconocimiento automático de dispositivos : identifica y categoriza dispositivos comunes (como Freebox, televisores, etc.)

• 📱 Información mejorada del dispositivo : obtenga información del fabricante, el tipo de dispositivo y características detalladas

• 🖥️ Compatibilidad multiplataforma : funciona en Windows, macOS y Linux

• ⚡ Optimizaciones específicas de la plataforma : capacidades de detección mejoradas en Windows

• 🤖 Integración MCP : Integración perfecta con Claude y asistentes de IA compatibles

📋 Requisitos

• Python 3.7+

• Adaptador Bluetooth (integrado o externo)

• Privilegios de administrador/sudo (necesarios para algunas operaciones de Bluetooth)

• Conexión a Internet (para la instalación del paquete)

🚀 Inicio rápido

Instalación

# 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

Ejecución del servidor

# Start the Bluetooth API server
python run.py

# In another terminal, start the MCP server
python bluetooth_mcp_server.py

Usando con Claude

1. Exponga su servidor a Internet usando ngrok o impleméntelo en un servidor:

   ngrok http 8000

2. Configurar Claude para utilizar su servidor MCP:

   npx @anthropic-ai/sdk install-model-context-protocol <YOUR_SERVER_URL>

3. Pídele a Claude que busque dispositivos Bluetooth:

   Could you scan for nearby Bluetooth devices?

🧪 Pruebas

Este proyecto sigue un enfoque de desarrollo impulsado por pruebas (TDD) con una cobertura de pruebas integral:

# 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

🏗️ Arquitectura

El proyecto sigue una arquitectura modular con una clara separación de preocupaciones:

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

Para obtener información detallada sobre la arquitectura, consulte arquitectura.md .

🔧 Solución de problemas

Problemas de Bluetooth

• Errores de "Acceso denegado" : Ejecute el servidor con privilegios de administrador/sudo

• Adaptador no detectado : asegúrese de que Bluetooth esté habilitado en la configuración de su sistema

• No se encontraron dispositivos : asegúrese de que haya dispositivos Bluetooth detectables cerca

• Problemas específicos de Windows : Compruebe que los servicios Bluetooth estén activos ( services.msc )

Problemas de MCP

• Herramienta no detectada por Claude : Verifique que la URL de su servidor MCP sea correcta y accesible

• Errores de ejecución : consulte los registros del servidor para obtener información detallada sobre los errores

👥 Contribuyendo

¡Agradecemos sus contribuciones! Siga estos pasos:

1. Bifurcar el repositorio

2. Crear una rama de características ( git checkout -b feature/amazing-feature )

3. Escribe pruebas para tu función

4. Implementa tu función

5. Asegúrese de que todas las pruebas pasen

6. Confirme sus cambios ( git commit -m 'Add amazing feature' )

7. Empujar a la rama ( git push origin feature/amazing-feature )

8. Abrir una solicitud de extracción

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🙏 Agradecimientos

• FastAPI para el marco de API

• Sombrío para la funcionalidad Bluetooth multiplataforma

• Claude Antrópico para soporte de integración de MCP