Bluetooth MCP サーバー

Bluetoothデバイス検出用のモデルコンテキストプロトコルサーバー

🔍 概要

このプロジェクトは、ClaudeをはじめとするAIアシスタントが周囲のBluetoothデバイスをスキャンし、操作できるようにするModel Context Protocol（MCP）サーバーを実装します。テスト駆動開発アプローチに基づいて構築されており、複数のプラットフォーム間でBluetoothを操作するための堅牢でテスト済みのインターフェースを提供します。

✨ 特徴

📡マルチプロトコルスキャン：BLEとClassic Bluetoothデバイスの両方を検出
🔎柔軟なフィルタリング：デバイスを名前、タイプ、その他の属性でフィルタリングします
🔄自動デバイス認識：一般的なデバイス（Freebox、テレビなど）を識別して分類します。
📱強化されたデバイス情報：メーカー情報、デバイスの種類、詳細な特性を取得します
🖥️クロスプラットフォームサポート：Windows、macOS、Linuxで動作します
⚡プラットフォーム固有の最適化: Windowsでの検出機能が強化されました
🤖 MCP 統合: Claude および互換性のある AI アシスタントとのシームレスな統合

📋 要件

Python 3.7以上
Bluetoothアダプタ（内蔵または外付け）
管理者/sudo 権限（一部の Bluetooth 操作に必要）
インターネット接続（パッケージインストール用）

🚀 クイックスタート

インストール

# 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

サーバーの実行

# Start the Bluetooth API server
python run.py

# In another terminal, start the MCP server
python bluetooth_mcp_server.py

クロードと一緒に使う

ngrok を使用してサーバーをインターネットに公開するか、サーバーに展開します。
ngrok http 8000
Claude が MCP サーバーを使用するように設定します。
npx @anthropic-ai/sdk install-model-context-protocol <YOUR_SERVER_URL>
Claude に Bluetooth デバイスをスキャンするよう依頼します。
Could you scan for nearby Bluetooth devices?

🧪 テスト

このプロジェクトは、包括的なテスト範囲を備えたテスト駆動開発 (TDD) アプローチに従います。

# 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

🏗️ 建築

このプロジェクトは、関心事が明確に分離されたモジュール型アーキテクチャを採用しています。

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

詳細なアーキテクチャ情報については、 architecture.md を参照してください。

🔧 トラブルシューティング

Bluetoothの問題

「アクセスが拒否されました」エラー: admin/sudo権限でサーバーを実行してください
アダプタが検出されません: システム設定で Bluetooth が有効になっていることを確認してください
デバイスが見つかりません: 近くに検出可能な Bluetooth デバイスがあることを確認してください
Windows 固有の問題: Bluetooth サービスがアクティブであることを確認してください ( services.msc )

MCPの問題

ツールがClaudeによって検出されませんでした: MCPサーバーのURLが正しくアクセス可能であることを確認してください
実行エラー: 詳細なエラー情報については、サーバーログを確認してください。

👥 貢献する

貢献を歓迎します！以下の手順に従ってください。

リポジトリをフォークする
機能ブランチを作成する ( git checkout -b feature/amazing-feature )
機能のテストを書く
機能を実装する
すべてのテストに合格することを確認する
変更をコミットします（ git commit -m 'Add amazing feature' ）
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

APIフレームワーク用のFastAPI
クロスプラットフォームBluetooth機能の実現は困難
MCP統合サポートのAnthropic Claude

Bluetooth MCP Server

Integrations