ultranix-mcp

Name: ultranix-mcp
Author: jxoesneon

jxoesneon

Get started Repository

Rust MCP server for Linux desktop automation — Wayland/Hyprland-first, UltraWin skeleton, UltraMac surface

Setup

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

Add to Cursor Add to VS Code

claude mcp add ultranix --env ULTRANIX_MCP_API_KEY='<ULTRANIX_MCP_API_KEY>' --env ULTRANIX_MCP_HISTORY_SECRET='<ULTRANIX_MCP_HISTORY_SECRET>' --env ULTRANIX_MCP_SENTRY_DSN='<ULTRANIX_MCP_SENTRY_DSN>' --env ULTRANIX_MCP_AUDIT_SECRET='<ULTRANIX_MCP_AUDIT_SECRET>' -- docker run -i --rm -e ULTRANIX_MCP_API_KEY -e ULTRANIX_MCP_HISTORY_SECRET -e ULTRANIX_MCP_SENTRY_DSN -e ULTRANIX_MCP_AUDIT_SECRET ghcr.io/jxoesneon/ultranix-mcp:1.4.0

~/.codex/config.toml

[mcp_servers.ultranix]
command = "docker"
args = ["run", "-i", "--rm", "-e", "ULTRANIX_MCP_API_KEY", "-e", "ULTRANIX_MCP_HISTORY_SECRET", "-e", "ULTRANIX_MCP_SENTRY_DSN", "-e", "ULTRANIX_MCP_AUDIT_SECRET", "ghcr.io/jxoesneon/ultranix-mcp:1.4.0"]
env = { ULTRANIX_MCP_API_KEY = "<ULTRANIX_MCP_API_KEY>", ULTRANIX_MCP_HISTORY_SECRET = "<ULTRANIX_MCP_HISTORY_SECRET>", ULTRANIX_MCP_SENTRY_DSN = "<ULTRANIX_MCP_SENTRY_DSN>", ULTRANIX_MCP_AUDIT_SECRET = "<ULTRANIX_MCP_AUDIT_SECRET>" }

# codex mcp add ultranix --env ULTRANIX_MCP_API_KEY='<ULTRANIX_MCP_API_KEY>' --env ULTRANIX_MCP_HISTORY_SECRET='<ULTRANIX_MCP_HISTORY_SECRET>' --env ULTRANIX_MCP_SENTRY_DSN='<ULTRANIX_MCP_SENTRY_DSN>' --env ULTRANIX_MCP_AUDIT_SECRET='<ULTRANIX_MCP_AUDIT_SECRET>' -- docker run -i --rm -e ULTRANIX_MCP_API_KEY -e ULTRANIX_MCP_HISTORY_SECRET -e ULTRANIX_MCP_SENTRY_DSN -e ULTRANIX_MCP_AUDIT_SECRET ghcr.io/jxoesneon/ultranix-mcp:1.4.0

~/.cursor/mcp.json

{
  "mcpServers": {
    "ultranix": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ULTRANIX_MCP_API_KEY",
        "-e",
        "ULTRANIX_MCP_HISTORY_SECRET",
        "-e",
        "ULTRANIX_MCP_SENTRY_DSN",
        "-e",
        "ULTRANIX_MCP_AUDIT_SECRET",
        "ghcr.io/jxoesneon/ultranix-mcp:1.4.0"
      ],
      "env": {
        "ULTRANIX_MCP_API_KEY": "<ULTRANIX_MCP_API_KEY>",
        "ULTRANIX_MCP_HISTORY_SECRET": "<ULTRANIX_MCP_HISTORY_SECRET>",
        "ULTRANIX_MCP_SENTRY_DSN": "<ULTRANIX_MCP_SENTRY_DSN>",
        "ULTRANIX_MCP_AUDIT_SECRET": "<ULTRANIX_MCP_AUDIT_SECRET>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "ultranix": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ULTRANIX_MCP_API_KEY",
        "-e",
        "ULTRANIX_MCP_HISTORY_SECRET",
        "-e",
        "ULTRANIX_MCP_SENTRY_DSN",
        "-e",
        "ULTRANIX_MCP_AUDIT_SECRET",
        "ghcr.io/jxoesneon/ultranix-mcp:1.4.0"
      ],
      "env": {
        "ULTRANIX_MCP_API_KEY": "<ULTRANIX_MCP_API_KEY>",
        "ULTRANIX_MCP_HISTORY_SECRET": "<ULTRANIX_MCP_HISTORY_SECRET>",
        "ULTRANIX_MCP_SENTRY_DSN": "<ULTRANIX_MCP_SENTRY_DSN>",
        "ULTRANIX_MCP_AUDIT_SECRET": "<ULTRANIX_MCP_AUDIT_SECRET>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "ultranix": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ULTRANIX_MCP_API_KEY",
        "-e",
        "ULTRANIX_MCP_HISTORY_SECRET",
        "-e",
        "ULTRANIX_MCP_SENTRY_DSN",
        "-e",
        "ULTRANIX_MCP_AUDIT_SECRET",
        "ghcr.io/jxoesneon/ultranix-mcp:1.4.0"
      ],
      "env": {
        "ULTRANIX_MCP_API_KEY": "<ULTRANIX_MCP_API_KEY>",
        "ULTRANIX_MCP_HISTORY_SECRET": "<ULTRANIX_MCP_HISTORY_SECRET>",
        "ULTRANIX_MCP_SENTRY_DSN": "<ULTRANIX_MCP_SENTRY_DSN>",
        "ULTRANIX_MCP_AUDIT_SECRET": "<ULTRANIX_MCP_AUDIT_SECRET>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "ultranix": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ULTRANIX_MCP_API_KEY",
        "-e",
        "ULTRANIX_MCP_HISTORY_SECRET",
        "-e",
        "ULTRANIX_MCP_SENTRY_DSN",
        "-e",
        "ULTRANIX_MCP_AUDIT_SECRET",
        "ghcr.io/jxoesneon/ultranix-mcp:1.4.0"
      ],
      "env": {
        "ULTRANIX_MCP_API_KEY": "<ULTRANIX_MCP_API_KEY>",
        "ULTRANIX_MCP_HISTORY_SECRET": "<ULTRANIX_MCP_HISTORY_SECRET>",
        "ULTRANIX_MCP_SENTRY_DSN": "<ULTRANIX_MCP_SENTRY_DSN>",
        "ULTRANIX_MCP_AUDIT_SECRET": "<ULTRANIX_MCP_AUDIT_SECRET>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "ultranix": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ULTRANIX_MCP_API_KEY",
        "-e",
        "ULTRANIX_MCP_HISTORY_SECRET",
        "-e",
        "ULTRANIX_MCP_SENTRY_DSN",
        "-e",
        "ULTRANIX_MCP_AUDIT_SECRET",
        "ghcr.io/jxoesneon/ultranix-mcp:1.4.0"
      ],
      "env": {
        "ULTRANIX_MCP_API_KEY": "<ULTRANIX_MCP_API_KEY>",
        "ULTRANIX_MCP_HISTORY_SECRET": "<ULTRANIX_MCP_HISTORY_SECRET>",
        "ULTRANIX_MCP_SENTRY_DSN": "<ULTRANIX_MCP_SENTRY_DSN>",
        "ULTRANIX_MCP_AUDIT_SECRET": "<ULTRANIX_MCP_AUDIT_SECRET>"
      }
    }
  }
}

Environment variables

ULTRANIX_MCP_API_KEY
ULTRANIX_MCP_HISTORY_SECRET
ULTRANIX_MCP_SENTRY_DSN
ULTRANIX_MCP_AUDIT_SECRET

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

Setup

Environment variables

Related