Bluetooth MCP Server

🚀 ブルートゥース MCP サーバー

このプロジェクトは、Claude やその他の AI アシスタントが周辺環境のブルートゥース機器をスキャンし、相互作用できるようにするモデルコンテキストプロトコル（MCP）サーバーを実装しています。テスト駆動開発手法で構築され、テスト済みのインターフェースを提供し、クロスプラットフォームのブルートゥース操作をサポートします。

🚀 クイックスタート

インストール

# リポジトリをクローンする
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 ファイルを参照してください。

🙏 謝辞

• FastAPI が API フレームワークを提供しています。
• Bleak がクロスプラットフォームのブルートゥース機能を提供しています。
• Anthropic Claude が MCP 統合をサポートしています。