Bluetooth MCP サーバー

ライセンス: MIT PythonバージョンファストAPI TDD

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

🔍 概要

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

Related MCP server: API Tester MCP Server

✨ 特徴

📡マルチプロトコルスキャン：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