ultranix-mcp
Secure Linux desktop automation - input, screen/OCR/vision, AT-SPI2 UI tree, window…
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.4.0
- Listing updated
- 6 days ago
About ultranix-mcp
ultranix-mcp is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Secure Linux desktop automation - input, screen/OCR/vision, AT-SPI2 UI tree, window, clipboard
Install
Run in a terminal
claude mcp add ultranix-mcp --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.0Add to claude_desktop_config.json
{
"mcpServers": {
"ultranix-mcp": {
"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>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ultranix-mcp": {
"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>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ultranix-mcp": {
"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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ultranix-mcp": {
"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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ultranix-mcp": {
"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>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ULTRANIX_MCP_API_KEYAPI key(s) (uxcp_*) for HTTP transport auth - required for --transport http (fail-closed), unused on stdioULTRANIX_MCP_API_KEY_FILEPath to a 0600 file holding uxcp_* keys, one per lineULTRANIX_MCP_API_KEY_EXPIRESOptional RFC 3339 expiry for the env-sourced key (self-revoking)ULTRANIX_MCP_HISTORY_SECRETAES-256-GCM secret for encrypted action history (per-install generated if unset)ULTRANIX_MCP_SENTRY_DSNOptional Sentry DSN for error reporting (unset = disabled)ULTRANIX_MCP_AUDIT_SECRETOptional HMAC-SHA256 signing secret for audit.jsonl lines (tamper evidence for SIEM ingestion)
Pricing
Open source
ultranix-mcp FAQ
Is ultranix-mcp free?
Yes. ultranix-mcp is open source, so you can use and self-host it for free.
How do I add ultranix-mcp to Claude Code?
Run this command in your terminal: claude mcp add ultranix-mcp --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
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.