OpenWrt MCP Server

This is a Model Context Protocol (MCP) server that allows you to interact with an OpenWrt router via SSH.

Prerequisites

• Node.js (v18 or higher)
• SSH access to your OpenWrt router (hostname/IP, username, and password or private key)

Setup

1. Configure: Copy .env.example to .env and fill in your router details.

    cp .env.example .env

Edit .env:

    ROUTER_HOST=192.168.1.1
    ROUTER_USER=root
    ROUTER_PASSWORD=your_password
    # Or use SSH_PRIVATE_KEY

1. Build:

    npm run build

Usage with MCP Client (e.g. Claude Desktop)

Add the following to your MCP client configuration (e.g., claude_desktop_config.json):

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

Make sure to replace /path/to/openwrt-mcp-server with the actual absolute path to this directory.

Available Tools

• execute_command: Execute arbitrary shell commands on the router.
• get_system_info: Get uptime, memory usage, and CPU info.
• read_file: Read a text file from the router.
• write_file: Write content to a file on the router.
• list_interfaces: List network interfaces.
• change_file_permissions: Change file permissions (chmod).
• change_file_owner: Change file owner/group (chown).

Security Note

This server allows arbitrary command execution on your router. Ensure it is only used by trusted clients and stored securely.