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: API Tester 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

Ejecución del servidor

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:

🏗️ Arquitectura

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

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