INSTALL.md

Installation

AETHER_02 supports four install paths. Use npm for the shortest setup, install.sh for full editor auto-registration, or build from source for development.

Method 1: npm global install

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

The postinstall script downloads the latest Linux binary from GitHub Releases into the package bin/ directory. The command exposed on PATH is:

aether-mcp-server

Method 2: one-click shell install

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

The script:

1. Downloads the latest release binary.
2. Creates .env with safe defaults.
3. Registers the server in detected MCP clients: Cursor, Claude Desktop, Windsurf, VS Code.

Method 3: editor install badges

Editor	Install
Cursor
VS Code
VS Code Insiders

If your browser or GitHub client does not open the Cursor deeplink, copy this into the browser address bar:

cursor://anysphere.cursor-deeplink/mcp/install?name=aether-02&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBmb3Vyc2Vjb25kZml2ZWZvdXIvYWV0aGVyLWxpbnV4LW1jcC1zZXJ2ZXIiXSwiZW52Ijp7IlJVU1RfTE9HIjoiaW5mbyJ9fQ==

Method 4: 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

Verify

aether-mcp-server --help

AETHER_02 is an MCP stdio server, so in normal operation it waits for JSON-RPC messages from an MCP client. Logs go to stderr; stdout is reserved for JSON-RPC.