Bluetooth MCP Server

🚀 藍牙 MCP 服務器

本項目實現了一個模型上下文協議（MCP）服務器，可助力Claude等AI助手掃描並與周圍環境中的藍牙設備進行交互。採用測試驅動開發方法構建，提供經過測試的接口，支持跨平臺的藍牙操作。

🚀 快速開始

安裝

# 克隆倉庫
git clone https://github.com/yourusername/bluetooth-mcp-server.git
cd bluetooth-mcp-server

# 創建並激活虛擬環境
python -m venv venv

# 在 Windows 上
venv\Scripts\activate
# 在 macOS/Linux 上
source venv/bin/activate

# 安裝依賴項
pip install -r requirements.txt

# 配置環境變量
cp .env.example .env
# 按需編輯 .env 文件

運行服務器

# 啟動藍牙 API 服務器
python run.py

# 在另一個終端，啟動 MCP 服務器
python bluetooth_mcp_server.py

與 Claude 使用

1. 使用 ngrok 或部署到服務器使您的服務器暴露於互聯網：

   ngrok http 8000
   

2. 配置 Claude 使用您的 MCP 服務器：

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

3. 讓 Claude 掃描附近的藍牙設備：

   能否掃描附近的藍牙設備？
   

✨ 主要特性

• 📡 多協議掃描：檢測經典藍牙和低能耗（BLE）藍牙設備
• 🔎 靈活過濾：按名稱、類型或其他屬性過濾設備
• 🔄 自動設備識別：識別並分類常見設備（如 Freebox、電視等）
• 📱 增強的設備信息：獲取製造商信息、設備類型和詳細特徵
• 🖥️ 跨平臺支持：適用於 Windows、macOS 和 Linux
• ⚡ 平臺特定優化：Windows 上的增強檢測功能
• 🤖 MCP 集成：與 Claude 和兼容的 AI 助手無縫集成

📦 安裝指南

先決條件

• Python 3.7+
• 藍牙適配器（內置或外部）
• 管理員/ sudo 權限（某些藍牙操作需要）
• 互聯網連接（用於包安裝）

🧪 測試

該項目採用測試驅動開發（TDD）方法，具有全面的測試覆蓋：

# 運行所有測試
pytest

# 運行特定測試類別
pytest tests/api/       # API 測試
pytest tests/models/    # 數據模型測試
pytest tests/services/  # 服務邏輯測試
pytest tests/utils/     # 工具測試

📄 許可證

該項目在 MIT License 下許可 - 請參閱 LICENSE 文件獲取詳細信息。

🙏 感謝

• FastAPI 提供 API 框架
• Bleak 提供跨平臺藍牙功能
• Anthropic Claude 支持 MCP 集成