AETHER 02

Rust License npm

Add AETHER_02 MCP server to Cursor Install in VS Code Install in VS Code Insiders

npm install Shell install

12 tools. 3 prompts. 20 resources. 99.9% Linux coverage. stdio-only.

AETHER_02 is a Rust MCP server that lets AI assistants operate a local Linux system through the Model Context Protocol. It covers process management, filesystem operations, package managers, system configuration, services, GUI automation, system info, networking, users, security, hardware control, and automation.

AETHER_02 is the Linux counterpart to AETHER_01 for Windows.

---

Quick install

npm

npm install -g @foursecondfivefour/aether-linux-mcp-server

Shell installer

curl -sSL https://raw.githubusercontent.com/foursecondfivefour/aether-linux-mcp-server/main/scripts/install/install.sh | bash

Build from source

git clone https://github.com/foursecondfivefour/aether-linux-mcp-server
cd aether-linux-mcp-server
cp config/env/.env.example .env
cargo build --release
./scripts/install/install.sh target/release/aether-mcp-server

More install/client details: docs/INSTALL.md, docs/MCP_CLIENTS.md.

---

Tool overview

#	Tool	Scope
1	process_control	Processes, signals, priorities, cgroups, namespaces, containers, perf
2	file_system	Files, ACL/xattr, symlinks, mounts, disks, LVM, swap, fsck, NFS, btrfs, ZFS
3	package_manager	apt, dnf, pacman, zypper, flatpak, snap, AppImage, nix
4	system_config	sysctl, kernel cmdline, modprobe, hostname, timezone, locale, udev, dconf
5	service_manager	systemd, OpenRC, runit, s6
6	gui_automation	X11/Wayland, mouse, keyboard, windows, screenshots, clipboard, display, audio
7	system_info	CPU, memory, disk, kernel, GPU, PCI, USB, DMI, ACPI, IOMMU, sensors
8	network_manager	iproute2, nftables, NetworkManager, WireGuard, bridges, WiFi, Bluetooth
9	user_management	users, groups, sessions, PAM, polkit, sudoers, SSH keys
10	security_audit	SELinux, AppArmor, auditd, firewall, TPM2, Secure Boot, IMA/EVM, hardening
11	hardware_control	GPU, PCI, USB authorization, ACPI, cpufreq, thermal, IOMMU, kdump
12	system_automation	journald, timers, cron/anacron, at, tmpfiles, sysusers, boot analysis

Full action list: docs/TOOLS.md.

---

Safety model

AETHER_02 is an administrative tool. It is intentionally powerful, so risky actions are guarded:

• stdio-only — no HTTP server and no listening TCP port.
• stdout stays JSON-RPC only — logs and audit output go to stderr.
• No shell interpolation — use syscalls or explicit argv vectors.
• Command allowlist blocks arbitrary command execution through command-backed handlers.
• force: true required for destructive operations.
• dry_run: true previews dangerous operations without mutating the host.
• Feature gates in .env protect critically dangerous capabilities.
• Audit logging records tool invocations.

Feature gates and hardening details: docs/SECURITY_MODEL.md.

---

Repository map

.
├── docs/                 # Detailed docs split by topic
├── scripts/              # Install and smoke-test helper scripts
├── config/               # Runtime/config examples
├── integrations/         # Marketplace/client metadata
├── src/                  # Rust MCP server implementation
│   └── tools/            # 12 Linux tool groups
├── tests/                # Config, error, dispatch, and smoke tests
├── .agents/              # Agent instructions and skill metadata
├── .cursor/              # Cursor project rules
├── .github/              # Issues, PR template, community docs
├── Cargo.toml            # Rust crate metadata
└── package.json          # npm package metadata

Detailed map: docs/PROJECT_STRUCTURE.md.

---

Structured tool output

Tool calls now return a JSON envelope as text content:

{
  "ok": true,
  "tool": "service_manager",
  "action": "status",
  "result": {
    "type": "command",
    "command_line": "systemctl status ssh --no-pager",
    "stdout": "...",
    "stderr": "...",
    "exit_code": 0
  }
}

Development

cargo fmt --check
cargo clippy -- -D warnings
cargo test

More: docs/DEVELOPMENT.md, docs/RELEASE.md.

---

License

MIT — see LICENSE.