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
- Configure: Copy
.env.exampleto.envand fill in your router details.
cp .env.example .envEdit .env: ```ini ROUTER_HOST=192.168.1.1 ROUTER_USER=root ROUTER_PASSWORD=your_password
Or use SSH_PRIVATE_KEY
2. **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.
