WiFi MCP Server

WiFi MCP サーバー

WiFi ネットワークの監視および管理ツールを提供する Model Context Protocol（MCP）サーバーです。このサーバーを Continue.dev、Claude Desktop、または MCP 対応の任意のクライアントと統合すると、AI アシスタントが WiFi 情報にリアルタイムでアクセスできます。

機能

• 📡 WiFi ネットワークのスキャン：利用可能な無線ネットワークを検出します
• 📊 接続状態：現在の WiFi 接続の詳細を取得します
• 📶 信号強度：信号の品質と強度の指標を監視します
• 🔌 インターフェース管理：ネットワークインターフェースを一覧表示して管理します
• 🔄 リアルタイム更新：ネットワークの状態をライブで監視します

前提条件

• Python 3.8 以降
• WiFi 機能を備えた Linux システム
• ネットワーク管理ツール：iw、iwconfig、ip（通常はプリインストールされています）
• 一部のネットワーク操作に必要な root/sudo アクセス

インストール

クイックセットアップ

# Clone or navigate to the project directory
cd ~/wifi-mcp-server

# Install dependencies
pip install -r requirements.txt

# Optional: Install in development mode
pip install -e .

仮想環境を使った別のセットアップ方法

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

デモの実行

1. 単体テスト

MCP と統合せずに WiFi ツールをテストします：

# Run standalone tests
python3 standalone_test.py

# Or use the Makefile
make test-standalone

2. MCP サーバーのテスト

MCP サーバーの全機能をテストします：

# Test all MCP tools
python3 test_wifi_server.py ./wifi_mcp_server.py

# Or use the Makefile
make test-mcp

3. MCP サーバーの実行

サーバーを stdio モードで起動します（MCP クライアントとの統合用）：

# Run the server directly
python3 wifi_mcp_server.py

# Or using the provided script
./run_server.sh

統合例

VS Code MCP 統合

WiFi MCP サーバーを Visual Studio Code と統合するには、次の内容を VS Code の設定（~/.config/Code/User/settings.json）に追加します：

{
    "mcp": {
        "servers": {
            "wifi-mcp-server": {
                "type": "stdio",
                "command": "~/wifi-mcp-server/wifi_mcp_server.py",
                "args": []
            }
        }
    }
}

これにより、MCP ベースの WiFi ツールを VS Code 内で直接利用できます。

利用可能なツール

1. scan_wifi

利用可能な WiFi ネットワークをスキャンします

パラメーター：

• interface（省略可能）：WiFi インターフェース名（例："wlan0"）

使用例：

# In Continue.dev chat:
"Scan for available WiFi networks"

2. get_wifi_status

現在の WiFi 接続状態を取得します

パラメーター：

• interface（省略可能）：WiFi インターフェース名

使用例：

# In Continue.dev chat:
"What's my current WiFi status?"

3. get_signal_strength

信号強度と品質の詳細な指標を取得します

パラメーター：

• interface（省略可能）：WiFi インターフェース名

使用例：

# In Continue.dev chat:
"Check my WiFi signal strength"

4. list_interfaces

利用可能なすべてのネットワークインターフェースを一覧表示します

使用例：

# In Continue.dev chat:
"Show me all network interfaces"

デモのシナリオ

基本的なネットワーク監視

1. 現在の状態を確認：

   "What's my current WiFi status?"
   

2. ネットワークをスキャン：

   "Scan and list available WiFi networks"
   

3. 信号品質を監視：

   "How strong is my WiFi signal?"
   

トラブルシューティングのワークフロー

1. ネットワーク診断：

   "Help me diagnose my WiFi connection issues"
   

2. ネットワークを比較：

   "Show me all available networks and their signal strengths"
   

3. インターフェース情報：

   "List all my network interfaces and their status"
   

開発

プロジェクト構成

wifi-mcp-server/
├── wifi_mcp_server.py          # Main MCP server implementation
├── test_wifi_server.py         # MCP server test suite
├── standalone_test.py          # Standalone functionality tests
├── requirements.txt            # Python dependencies
├── setup.py                    # Package setup configuration
├── Makefile                    # Build and test commands
└── README.md                   # This file

テストの実行

# Run all tests
make test

# Run specific test suites
make test-standalone  # Test WiFi functions directly
make test-mcp        # Test MCP server functionality

# Run with verbose output
python3 test_wifi_server.py ./wifi_mcp_server.py

開発環境のセットアップ

# Set up development environment
make dev-setup

# Install in development mode
make install

# Format code
make lint

トラブルシューティング

よくある問題

1. 権限エラー：

   # Some WiFi operations require sudo
   sudo python3 wifi_mcp_server.py
   

2. 依存関係の不足：

   pip install mcp
   

3. ネットワークツールが見つからない：

   # Install wireless tools (Ubuntu/Debian)
   sudo apt install wireless-tools iw net-tools
   
   # Install wireless tools (CentOS/RHEL)
   sudo yum install wireless-tools iw net-tools
   

4. MCP サーバーが起動しない：

   # Check if MCP library is installed
   python3 -c "import mcp; print('MCP installed successfully')"
   
   # Run server with debug output
   python3 wifi_mcp_server.py 2>&1 | tee debug.log
   

デバッグモード

環境変数を設定してデバッグログを有効にします：

export DEBUG=1
python3 wifi_mcp_server.py

統合の確認

1. MCP サーバーを直接テスト：

   echo '{"jsonrpc":"2.0","id":0,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | python3 wifi_mcp_server.py
   

2. Continue.dev との統合を確認：

   • Continue.dev のログを確認します：~/.continue/logs/continue.log
   • MCP サーバーの読み込みメッセージを探します
   • 簡単な WiFi クエリでテストします

3. ネットワークインターフェースを確認：

   # List wireless interfaces
   iw dev
   
   # Check interface status
   ip link show
   

ライセンス

このプロジェクトは、LICENSE ファイルに記載された条件に基づいてライセンスされています。

出力例

WiFi 状態の例

{
    "interface": "wlan0",
    "connected_ssid": "ExampleSSID",
    "access_point": "00:11:22:33:44:55",
    "bit_rate": 300.0,
    "link_quality": {
        "current": 40,
        "max": 70
    },
    "signal_level": -60
}

ネットワークスキャンの例

{
    "interface": "wlan0",
    "networks": [
        {
            "bssid": "00:11:22:33:44:55",
            "frequency": 5180.0,
            "signal": -60,
            "ssid": "ExampleSSID"
        },
        {
            "bssid": "66:77:88:99:AA:BB",
            "frequency": 2412.0,
            "signal": -50,
            "ssid": "GuestNetwork"
        }
    ],
    "scan_time": 1234567.890123
}

---

クイックスタートデモ

1. セットアップとインストール

# Clone or navigate to the project directory
cd ~/wifi-mcp-server

# Option A: Quick setup (system Python)
pip install -r requirements.txt

# Option B: Development setup with virtual environment
make dev-setup
source venv/bin/activate  # Activate the virtual environment

2. WiFi 関数のテスト

# Test standalone WiFi functions (no MCP required)
python3 standalone_test.py

# Expected output: Lists interfaces, shows WiFi status, etc.

3. MCP サーバーのテスト

# Test the full MCP server with all tools
python3 test_wifi_server.py ./wifi_mcp_server.py

# Expected output: JSON responses for scan, status, signal strength

4. MCP サーバーの実行

# Start the server in stdio mode
python3 wifi_mcp_server.py

# The server will wait for JSON-RPC commands via stdin
# Press Ctrl+C to stop

5. VS Code との統合

次の内容を VS Code の設定（~/.config/Code/User/settings.json）に追加します：

{
    "mcp": {
        "servers": {
            "wifi-mcp-server": {
                "type": "stdio",
                "command": "~/wifi-mcp-server/wifi_mcp_server.py",
                "args": []
            }
        }
    }
}

6. エージェントをローカルで実行する

# Start the MCP server in HTTP mode
nohup python3 wifi_mcp_server.py --mode http &
python3 ./wifi_agent.py --llm-url http://localhost:8000 -model llama3.1:8b --wifi-server-url http://localhost:8080

注： Intel GPU アクセラレーションを有効にして Ollama を実行するには、mattcurf/ollama-intel-gpu Docker サービスを使用しました。これにより、Intel ハードウェア上で効率的な LLM 推論が可能になります。

6. デモコマンド

統合が完了したら、VS Code のチャットで次のコマンドを試してください：

"What's my current WiFi status?"
"Scan for available WiFi networks"
"Check my WiFi signal strength"
"List all network interfaces"