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.
✨ 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
- Exponga su servidor a Internet usando ngrok o impleméntelo en un servidor:
- Configurar Claude para utilizar su servidor MCP:
npx @anthropic-ai/sdk install-model-context-protocol <YOUR_SERVER_URL>
- 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:
- Bifurcar el repositorio
- Crear una rama de características (
git checkout -b feature/amazing-feature ) - Escribe pruebas para tu función
- Implementa tu función
- Asegúrese de que todas las pruebas pasen
- Confirme sus cambios (
git commit -m 'Add amazing feature' ) - Empujar a la rama (
git push origin feature/amazing-feature ) - 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