远程唤醒服务

一个基于MCP协议的远程唤醒服务器,允许用户通过MAC地址唤醒局域网内的设备,支持设备信息管理和多种传输模式。

  • by lkanyun
  • Python
  • 混合部署
  • 2 星标
  • 更新于
在 GitHub 查看 lkanyun/mcp-server-wake-on-lan

使用说明

局域网MCP服务器唤醒

概述

一种模型上下文协议(MCP)服务器,允许您远程唤醒本地网络上的设备。此MCP服务器有意设计得简单明了,只需要最少的设置。

特性

  • 使用MAC地址唤醒网络设备
  • 保存和管理设备信息(名称和MAC地址)
  • 列出所有已保存的设备
  • 删除设备记录
  • 支持标准局域网唤醒协议
  • 双传输模式:SSE和stdio
  • 简单的命令行界面

示例提示

# Wake up a device
Wake up my home desktop (MAC: 00:11:22:33:44:55)

# Save device information
Save my desktop PC with MAC address 00:11:22:33:44:55

# List all saved devices
Show me all my saved devices

# Wake up an existing device
Wake up my desktop PC

# Delete a device record
Remove the device with MAC address 00:11:22:33:44:55

# Delete a device record by name
Remove the mac record of my desktop PC

设备管理

服务器将设备信息存储在 ~/.config/mcp-wake-on-lan/devices.json。这使您能够:

  • 保存设备名称及其MAC地址
  • 列出所有已保存的设备
  • 需要时删除设备记录

使用Claude Desktop

安装

brew install uv
git clone ...

配置

将以下配置添加到Claude Desktop:

{
  "mcpServers": {
    "mcp-wake-on-lan": {
      "command": "uvx",
      "args": [
        "mcp-wake-on-lan",
        "--broadcast-addr",
        "192.168.1.255"
      ]
    }
  }
}

Docker部署

Docker运行

docker run -d --network host lkanyun/mcp-server-wake-on-lan --broadcast-addr 192.168.1.255

Docker Compose

创建一个 docker-compose.yml 文件:

version: '3'
services:
  mcp-wake-on-lan:
    image: lkanyun/mcp-server-wake-on-lan
    network_mode: host
    volumes:
      - /your_path:/root/.config/mcp-wake-on-lan
    command:
      - --broadcast-addr
      - 192.168.1.255
    restart: unless-stopped

运行:

docker compose up -d

注: network_mode: host 需要确保LAN唤醒魔术包能够正确发送到本地网络。

Claude桌面上的配置

{
  "mcpServers": {
    "mcp-server-wake-on-lan": {
      "type": "sse",
      "url": "http://yourip:8000/sse"
    }
  }
}