WiFi MCP Server

WiFi MCP 服务

一个用于提供 WiFi 网络监控和管理工具的模型上下文协议（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": []
            }
        }
    }
}

这样即可在 VS Code 中直接使用基于 MCP 的 WiFi 工具。

可用工具

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. 在本地运行 Agent

# 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 硬件上高效地进行大模型推理。

6. 演示命令

集成完成后，请在 VS Code 聊天中尝试以下命令：

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