MCP 服务器

Bluetooth MCP Server

一个 ModelContextProtocol 服务器，使 Claude AI 能够检测和扫描附近的蓝牙设备，通过兼容的 MCP 接口为 Claude 提供蓝牙感知能力。

README

Bluetooth MCP 服务器

用于蓝牙设备检测的模型上下文协议服务器

</div>

🔍 概述

本项目实现了一个模型上下文协议 (MCP) 服务器，使 Claude 和其他 AI 助手能够扫描并与您附近的蓝牙设备进行交互。它采用测试驱动开发方法构建，为跨多个平台的蓝牙操作提供了一个强大且经过测试的接口。

✨ 特性

📡 多协议扫描：检测 BLE 和经典蓝牙设备
🔎 灵活的过滤：按名称、类型或其他属性过滤设备
🔄 自动设备识别：识别和分类常见设备（如 Freebox、电视等）
📱 增强的设备信息：获取制造商信息、设备类型和详细特征
🖥️ 跨平台支持：可在 Windows、macOS 和 Linux 上运行
⚡ 平台特定优化：增强了 Windows 上的检测能力
🤖 MCP 集成：与 Claude 和兼容的 AI 助手无缝集成

📋 要求

Python 3.7+
蓝牙适配器（内置或外部）
管理员/sudo 权限（某些蓝牙操作需要）
互联网连接（用于安装软件包）

🚀 快速开始

安装

# 克隆仓库
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 一起使用

使用 ngrok 将您的服务器暴露到互联网，或将其部署到服务器：
```
ngrok http 8000
```

配置 Claude 以使用您的 MCP 服务器：

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

要求 Claude 扫描蓝牙设备：

Could you scan for nearby Bluetooth devices?

🧪 测试

本项目遵循测试驱动开发 (TDD) 方法，具有全面的测试覆盖率：

# 运行所有测试
pytest

# 运行特定测试类别
pytest tests/api/       # API 测试
pytest tests/models/    # 数据模型测试
pytest tests/services/  # 服务逻辑测试
pytest tests/utils/     # 实用函数测试

🏗️ 架构

该项目遵循模块化架构，具有清晰的关注点分离：

bluetooth-mcp-server/
├── app/                # 主应用程序包
│   ├── api/            # FastAPI 端点
│   ├── core/           # 核心配置
│   ├── data/           # 静态数据（蓝牙标识符等）
│   ├── models/         # 数据模型
│   ├── services/       # 业务逻辑
│   └── utils/          # 实用函数
├── mcp_sdk/            # MCP 集成 SDK
└── tests/              # 测试套件

有关详细的架构信息，请参阅 architecture.md。