GNOME UI MCP MCP Server

Name: GNOME UI MCP MCP Server
Author: io.github.asattelmaier

io.github.asattelmaier/gnome-ui-mcp

Repository Registry

What is the GNOME UI MCP MCP server?

GNOME Wayland desktop automation via AT-SPI discovery and Mutter input.

How to install GNOME UI MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gnome-ui-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/asattelmaier/gnome-ui-mcp:0.5.0",
        "run",
        "-i",
        "--rm",
        "--security-opt",
        "apparmor=unconfined",
        "--network",
        "host",
        "--user",
        "{uid}:{gid}",
        "-e",
        "DBUS_SESSION_BUS_ADDRESS",
        "-e",
        "XDG_RUNTIME_DIR",
        "-e",
        "WAYLAND_DISPLAY",
        "-e",
        "DISPLAY",
        "-e",
        "XDG_SESSION_TYPE",
        "-v",
        "{xdg_runtime_dir}:{xdg_runtime_dir}",
        "-v",
        "/tmp/.X11-unix:/tmp/.X11-unix:ro"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "gnome-ui-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/asattelmaier/gnome-ui-mcp:0.5.0",
        "run",
        "-i",
        "--rm",
        "--security-opt",
        "apparmor=unconfined",
        "--network",
        "host",
        "--user",
        "{uid}:{gid}",
        "-e",
        "DBUS_SESSION_BUS_ADDRESS",
        "-e",
        "XDG_RUNTIME_DIR",
        "-e",
        "WAYLAND_DISPLAY",
        "-e",
        "DISPLAY",
        "-e",
        "XDG_SESSION_TYPE",
        "-v",
        "{xdg_runtime_dir}:{xdg_runtime_dir}",
        "-v",
        "/tmp/.X11-unix:/tmp/.X11-unix:ro"
      ]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gnome-ui-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/asattelmaier/gnome-ui-mcp:0.5.0",
        "run",
        "-i",
        "--rm",
        "--security-opt",
        "apparmor=unconfined",
        "--network",
        "host",
        "--user",
        "{uid}:{gid}",
        "-e",
        "DBUS_SESSION_BUS_ADDRESS",
        "-e",
        "XDG_RUNTIME_DIR",
        "-e",
        "WAYLAND_DISPLAY",
        "-e",
        "DISPLAY",
        "-e",
        "XDG_SESSION_TYPE",
        "-v",
        "{xdg_runtime_dir}:{xdg_runtime_dir}",
        "-v",
        "/tmp/.X11-unix:/tmp/.X11-unix:ro"
      ]
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "gnome-ui-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/asattelmaier/gnome-ui-mcp:0.5.0",
        "run",
        "-i",
        "--rm",
        "--security-opt",
        "apparmor=unconfined",
        "--network",
        "host",
        "--user",
        "{uid}:{gid}",
        "-e",
        "DBUS_SESSION_BUS_ADDRESS",
        "-e",
        "XDG_RUNTIME_DIR",
        "-e",
        "WAYLAND_DISPLAY",
        "-e",
        "DISPLAY",
        "-e",
        "XDG_SESSION_TYPE",
        "-v",
        "{xdg_runtime_dir}:{xdg_runtime_dir}",
        "-v",
        "/tmp/.X11-unix:/tmp/.X11-unix:ro"
      ]
    }
  }
}

Claude Code

claude mcp add gnome-ui-mcp -- docker run -i --rm ghcr.io/asattelmaier/gnome-ui-mcp:0.5.0 run -i --rm --security-opt apparmor=unconfined --network host --user {uid}:{gid} -e DBUS_SESSION_BUS_ADDRESS -e XDG_RUNTIME_DIR -e WAYLAND_DISPLAY -e DISPLAY -e XDG_SESSION_TYPE -v {xdg_runtime_dir}:{xdg_runtime_dir} -v /tmp/.X11-unix:/tmp/.X11-unix:ro