路由器管理服务器

OpenWrt MCP服务器是一个基于SSH的OpenWrt路由器交互工具,支持执行命令、读写文件和获取系统信息等功能。

  • by hady2010
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 hady2010/openwrt-mcp

使用说明

OpenWrt MCP服务器

这是一个模型上下文协议(MCP)服务器,允许您通过SSH与OpenWrt路由器进行交互。

先决条件

  • Node.js(v18或更高版本)
  • SSH访问您的OpenWrt路由器(主机名/IP、用户名和密码或私钥)

设置

  1. 配置:复制 .env.example 到 .env 并填写您的路由器详细信息。

    cp .env.example .env
    

    编辑 .env:

    ROUTER_HOST=192.168.1.1
    ROUTER_USER=root
    ROUTER_PASSWORD=your_password
    # Or use SSH_PRIVATE_KEY
    
  2. 构建:

    npm run build
    

使用MCP客户端(例如Claude Desktop)

将以下内容添加到MCP客户端配置中(例如。, claude_desktop_config.json):

{
  "mcpServers": {
    "openwrt": {
      "command": "node",
      "args": ["/path/to/openwrt-mcp-server/dist/index.js"]
    }
  }
}

确保更换 /path/to/openwrt-mcp-server 此目录的实际绝对路径。

可用工具

  • execute_command:在路由器上执行任意shell命令。
  • get_system_info:获取正常运行时间、内存使用情况和CPU信息。
  • read_file:从路由器读取文本文件。
  • write_file:将内容写入路由器上的文件。
  • list_interfaces:列出网络接口。
  • change_file_permissions:更改文件权限(chmod)。
  • change_file_owner:更改文件所有者/组(chown)。

安全说明

此服务器允许在路由器上执行任意命令。确保它仅由受信任的客户端使用并安全存储。