Wake-on-LAN MCP 服务器

概述

这是一个模型上下文协议（MCP）服务器，允许您远程唤醒局域网中的设备。此MCP服务器被设计得尽可能简单、直接，并且需要最少的设置。

特性

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

示例提示

# 唤醒一个设备
唤醒我的家用台式机 (MAC: 00:11:22:33:44:55)

# 保存设备信息
保存我的台式PC，其MAC地址为00:11:22:33:44:55

# 列出所有已保存的设备
显示我所有的已保存设备

# 唤醒一个已存在的设备
唤醒我的台式PC

# 删除一个设备记录
移除MAC地址为00:11:22:33:44:55的设备

# 根据名称删除一个设备记录
移除我的台式PC的MAC记录

设备管理

服务器将设备信息存储在~/.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是必需的，以确保Wake-on-LAN魔包能够正确发送到本地网络。

Claude Desktop上的配置

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