ASUS Merlin MCP

Name: ASUS Merlin MCP
Author: kcsoukup

kcsoukup

Get started Repository

Manages ASUS routers running Asuswrt-Merlin firmware over SSH and SCP.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add asus-merlin --env ROUTER_HOST='<ROUTER_HOST>' --env ROUTER_KEY_FILE='<ROUTER_KEY_FILE>' --env ROUTER_PORT='<ROUTER_PORT>' --env ROUTER_USER='<ROUTER_USER>' -- docker run -i --rm -v /home/yourusername/.ssh:/home/mcpuser/.ssh:ro -e ROUTER_HOST=192.168.1.1 -e ROUTER_USER=admin -e ROUTER_KEY_FILE=/home/mcpuser/.ssh/id_rsa kcsoukup/asus-merlin-mcp:latest

~/.codex/config.toml

[mcp_servers.asus-merlin]
command = "docker"
args = ["run", "-i", "--rm", "-v", "/home/yourusername/.ssh:/home/mcpuser/.ssh:ro", "-e", "ROUTER_HOST=192.168.1.1", "-e", "ROUTER_USER=admin", "-e", "ROUTER_KEY_FILE=/home/mcpuser/.ssh/id_rsa", "kcsoukup/asus-merlin-mcp:latest"]
env = { ROUTER_HOST = "<ROUTER_HOST>", ROUTER_KEY_FILE = "<ROUTER_KEY_FILE>", ROUTER_PORT = "<ROUTER_PORT>", ROUTER_USER = "<ROUTER_USER>" }

# codex mcp add asus-merlin --env ROUTER_HOST='<ROUTER_HOST>' --env ROUTER_KEY_FILE='<ROUTER_KEY_FILE>' --env ROUTER_PORT='<ROUTER_PORT>' --env ROUTER_USER='<ROUTER_USER>' -- docker run -i --rm -v /home/yourusername/.ssh:/home/mcpuser/.ssh:ro -e ROUTER_HOST=192.168.1.1 -e ROUTER_USER=admin -e ROUTER_KEY_FILE=/home/mcpuser/.ssh/id_rsa kcsoukup/asus-merlin-mcp:latest

~/.cursor/mcp.json

{
  "mcpServers": {
    "asus-merlin": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/home/yourusername/.ssh:/home/mcpuser/.ssh:ro",
        "-e",
        "ROUTER_HOST=192.168.1.1",
        "-e",
        "ROUTER_USER=admin",
        "-e",
        "ROUTER_KEY_FILE=/home/mcpuser/.ssh/id_rsa",
        "kcsoukup/asus-merlin-mcp:latest"
      ],
      "env": {
        "ROUTER_HOST": "<ROUTER_HOST>",
        "ROUTER_KEY_FILE": "<ROUTER_KEY_FILE>",
        "ROUTER_PORT": "<ROUTER_PORT>",
        "ROUTER_USER": "<ROUTER_USER>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "asus-merlin": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/home/yourusername/.ssh:/home/mcpuser/.ssh:ro",
        "-e",
        "ROUTER_HOST=192.168.1.1",
        "-e",
        "ROUTER_USER=admin",
        "-e",
        "ROUTER_KEY_FILE=/home/mcpuser/.ssh/id_rsa",
        "kcsoukup/asus-merlin-mcp:latest"
      ],
      "env": {
        "ROUTER_HOST": "<ROUTER_HOST>",
        "ROUTER_KEY_FILE": "<ROUTER_KEY_FILE>",
        "ROUTER_PORT": "<ROUTER_PORT>",
        "ROUTER_USER": "<ROUTER_USER>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "asus-merlin": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/home/yourusername/.ssh:/home/mcpuser/.ssh:ro",
        "-e",
        "ROUTER_HOST=192.168.1.1",
        "-e",
        "ROUTER_USER=admin",
        "-e",
        "ROUTER_KEY_FILE=/home/mcpuser/.ssh/id_rsa",
        "kcsoukup/asus-merlin-mcp:latest"
      ],
      "env": {
        "ROUTER_HOST": "<ROUTER_HOST>",
        "ROUTER_KEY_FILE": "<ROUTER_KEY_FILE>",
        "ROUTER_PORT": "<ROUTER_PORT>",
        "ROUTER_USER": "<ROUTER_USER>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "asus-merlin": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/home/yourusername/.ssh:/home/mcpuser/.ssh:ro",
        "-e",
        "ROUTER_HOST=192.168.1.1",
        "-e",
        "ROUTER_USER=admin",
        "-e",
        "ROUTER_KEY_FILE=/home/mcpuser/.ssh/id_rsa",
        "kcsoukup/asus-merlin-mcp:latest"
      ],
      "env": {
        "ROUTER_HOST": "<ROUTER_HOST>",
        "ROUTER_KEY_FILE": "<ROUTER_KEY_FILE>",
        "ROUTER_PORT": "<ROUTER_PORT>",
        "ROUTER_USER": "<ROUTER_USER>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "asus-merlin": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/home/yourusername/.ssh:/home/mcpuser/.ssh:ro",
        "-e",
        "ROUTER_HOST=192.168.1.1",
        "-e",
        "ROUTER_USER=admin",
        "-e",
        "ROUTER_KEY_FILE=/home/mcpuser/.ssh/id_rsa",
        "kcsoukup/asus-merlin-mcp:latest"
      ],
      "env": {
        "ROUTER_HOST": "<ROUTER_HOST>",
        "ROUTER_KEY_FILE": "<ROUTER_KEY_FILE>",
        "ROUTER_PORT": "<ROUTER_PORT>",
        "ROUTER_USER": "<ROUTER_USER>"
      }
    }
  }
}

Environment variables

ROUTER_HOST
ROUTER_KEY_FILE
ROUTER_PORT
ROUTER_USER

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related