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:
ngrok http 8000
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

FastAPI para el marco de API
Sombrío para la funcionalidad Bluetooth multiplataforma
Claude Antrópico para soporte de integración de MCP

Bluetooth MCP Server

Integrations