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

1. 构建:

   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）。

安全说明

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