impreza-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Impreza Host
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,167 @@
+# impreza-mcp
+
+[Model Context Protocol](https://modelcontextprotocol.io) server for
+[Impreza Host](https://imprezahost.com). Lets AI coding tools (Claude
+Code, Cursor, Codex CLI, Continue, Zed, ...) deploy customer-built
+apps to managed Impreza VPSes without leaving the chat.
+
+When you say "deploy this for me" to Claude with this MCP server
+loaded, Claude calls `impreza_deploy_custom` directly — packages your
+project, uploads it, builds + runs on your Impreza VPS, and reports
+back the URL.
+
+## Status
+
+**0.1.0 — full surface live.** All 10 tools shipped + a setup wizard
+that generates ready-to-paste config snippets for 5 AI tools.
+Roadmap context lives in
+[`docs/PLAN_AI_INTEGRATION_ROADMAP.md`](https://git.imprezahost.com/impreza/impreza-platform/-/blob/main/docs/PLAN_AI_INTEGRATION_ROADMAP.md)
+of the impreza-platform repo.
+
+| Tool | Wraps |
+|------|-------|
+| `impreza_list_servers` | `GET /v1/platform/servers` |
+| `impreza_list_apps` | `GET /v1/platform/apps` |
+| `impreza_list_deployments` | `GET /v1/platform/deployments` + `/custom` (merged) |
+| `impreza_deploy_custom` | `POST /v1/platform/deployments/custom` (3 modes) |
+| `impreza_deploy_catalog_app` | `POST /v1/platform/deployments` |
+| `impreza_uninstall_deployment` | `POST .../uninstall` |
+| `impreza_get_logs` | `POST .../logs` (sync tail, last N lines) |
+| `impreza_restart_deployment` | `POST .../restart` |
+| `impreza_add_onion` | `POST .../onion/add` |
+| `impreza_change_domain` | `POST .../domain` |
+
+## Install + setup
+
+### Prerequisites
+
+  - Node ≥ 20
+  - An Impreza Host account with an API key + secret
+    (clientarea → API Keys; the IP of the machine running this MCP
+    server must be whitelisted under the key)
+
+### One-shot via `npx`
+
+No global install needed — `npx impreza-mcp` works.
+
+### Or install globally
+
+```sh
+npm install -g impreza-mcp
+```
+
+### Get a ready-to-paste config snippet
+
+The fastest path: ask the binary itself.
+
+```sh
+npx impreza-mcp setup --tool claude-code
+# also: cursor | continue | zed | codex-cli
+```
+
+The wizard prints the JSON block to drop into your AI tool's MCP
+config + the exact file path + the post-config step (usually "fully
+quit + re-open the AI tool"). It does NOT write to disk — paste it
+yourself so you don't accidentally clobber an existing config with
+other MCP servers.
+
+### Or wire it in manually
+
+**Claude Code** — add to `~/Library/Application Support/Claude/claude_desktop_config.json`
+(macOS) or `%APPDATA%/Claude/claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "impreza": {
+      "command": "npx",
+      "args": ["-y", "impreza-mcp"],
+      "env": {
+        "IMPREZA_API_KEY": "imp_...",
+        "IMPREZA_API_SECRET": "..."
+      }
+    }
+  }
+}
+```
+
+Restart Claude Code. The tools appear under the MCP icon.
+
+**Cursor** — add to `~/.cursor/mcp.json` (same shape as above).
+
+**Continue** — add to `~/.continue/config.json`:
+
+```json
+{
+  "experimental": {
+    "modelContextProtocolServers": [
+      {
+        "transport": {
+          "type": "stdio",
+          "command": "npx",
+          "args": ["-y", "impreza-mcp"],
+          "env": {
+            "IMPREZA_API_KEY": "imp_...",
+            "IMPREZA_API_SECRET": "..."
+          }
+        }
+      }
+    ]
+  }
+}
+```
+
+**Zed** — add to your settings:
+
+```json
+{
+  "context_servers": {
+    "impreza": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "impreza-mcp"],
+        "env": {
+          "IMPREZA_API_KEY": "imp_...",
+          "IMPREZA_API_SECRET": "..."
+        }
+      }
+    }
+  }
+}
+```
+
+## Usage in chat
+
+After setup, talk to your AI naturally:
+
+> *"List my Impreza servers."* → calls `impreza_list_servers`
+>
+> *"Deploy this directory to my Impreza VPS, expose via .onion."* →
+> packages the cwd as a Dockerfile-mode custom deploy, uploads, deploys
+> with `onion=true`, reports the .onion address.
+>
+> *"What apps are running on my agent?"* → calls
+> `impreza_list_deployments` filtered to the right server.
+
+## Auth + security
+
+`IMPREZA_API_KEY` + `IMPREZA_API_SECRET` live in the AI tool's MCP
+config env — not in any file on disk owned by `impreza-mcp` itself.
+The MCP server holds the secret only in memory and only attaches it
+as HTTP request headers.
+
+The IP of the machine running this MCP server (almost always your
+laptop) must be on the API key's whitelist. Manage the whitelist in
+your Impreza clientarea.
+
+## Build
+
+```sh
+npm install
+npm run build
+# dist/server.js is the entry point
+```
+
+## License
+
+MIT — see `LICENSE`.

package/dist/client.d.ts

@@ -0,0 +1,104 @@
+export interface ImprezaConfig {
+    baseURL: string;
+    apiKey: string;
+    apiSecret: string;
+    /** Wall-clock budget per HTTP call. Default 60s. */
+    timeoutMs?: number;
+}
+export declare class ImprezaClient {
+    private readonly baseURL;
+    private readonly apiKey;
+    private readonly apiSecret;
+    private readonly timeoutMs;
+    constructor(cfg: ImprezaConfig);
+    /**
+     * Authenticated GET. Decodes the standard envelope ({success, data,
+     * meta}) and returns the `data` payload typed as T. Throws on non-2xx
+     * or success=false.
+     */
+    get<T>(path: string, query?: Record<string, string>): Promise<T>;
+    /**
+     * Authenticated JSON POST. body is JSON.stringified; response decoded
+     * as envelope.
+     */
+    post<T>(path: string, body: unknown): Promise<T>;
+    /**
+     * Authenticated POST with raw binary body. Used for the Phase 12
+     * context upload (`POST /v1/platform/deployments/custom/contexts`)
+     * which accepts a gzip tarball as the raw body.
+     */
+    postRaw<T>(path: string, contentType: string, bytes: Uint8Array): Promise<T>;
+    private fetch;
+    private parseEnvelope;
+}
+export interface Server_ {
+    agent_id: string;
+    hostname: string;
+    origin: string;
+    service_id?: number | null;
+    status: string;
+    version?: string;
+    last_seen_at?: string;
+}
+export interface ServerList {
+    servers: Server_[];
+    total: number;
+}
+export interface App {
+    name: string;
+    display_name: string;
+    version: string;
+    category: string;
+    tags?: string[];
+    description?: string;
+    icon_url?: string;
+}
+export interface AppList {
+    apps: App[];
+    total: number;
+}
+export interface Deployment {
+    id: string;
+    app_name?: string;
+    app_version?: string;
+    name?: string;
+    mode?: string;
+    agent_id: string;
+    status: string;
+    domain?: string | null;
+    onion?: string | null;
+    image?: string;
+    cpus?: number;
+    memory_mb?: number;
+    vars?: Record<string, unknown>;
+    created_at: string;
+    last_health_at?: string | null;
+    last_error?: string | null;
+}
+export interface DeploymentList {
+    deployments: Deployment[];
+    total: number;
+}
+export interface CustomDeployContextUpload {
+    context_id: string;
+    sha256: string;
+    size_bytes: number;
+    expires_at: string;
+}
+/**
+ * Tar + gzip the given project directory into a temp file, return
+ * the bytes + the temp path (so the caller can delete it after
+ * upload). Excludes the usual suspects (.git, node_modules,
+ * __pycache__, etc.) baked into the same list the Go CLI uses.
+ *
+ * The tar is rooted at the project dir contents (entries are
+ * `Dockerfile`, `main.go`, etc., not `proj/Dockerfile`), matching
+ * what the agent's extractor expects.
+ */
+export declare function tarProjectDir(projectDir: string): Promise<{
+    bytes: Uint8Array;
+    sizeBytes: number;
+    cleanup: () => Promise<void>;
+}>;
+/** Lowercase hex sha256 of the given bytes. */
+export declare function sha256Hex(bytes: Uint8Array): string;

package/dist/client.js

@@ -0,0 +1,175 @@
+// Tiny Impreza Host REST client. Hand-written to match the public
+// OpenAPI surface in impreza-platform/specs/openapi-platform.yaml.
+//
+// Auth: standard X-API-Key + X-API-Secret headers, sourced from env.
+// Network: native fetch (Node ≥ 20 has it). No retry / circuit-breaker
+// in v1 — the AI client retries the tool call if it cares.
+import { createHash } from 'node:crypto';
+import { readFile, stat } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createWriteStream } from 'node:fs';
+import { unlink } from 'node:fs/promises';
+import * as tar from 'tar';
+export class ImprezaClient {
+    baseURL;
+    apiKey;
+    apiSecret;
+    timeoutMs;
+    constructor(cfg) {
+        this.baseURL = cfg.baseURL.replace(/\/+$/, '');
+        this.apiKey = cfg.apiKey;
+        this.apiSecret = cfg.apiSecret;
+        this.timeoutMs = cfg.timeoutMs ?? 60_000;
+    }
+    /**
+     * Authenticated GET. Decodes the standard envelope ({success, data,
+     * meta}) and returns the `data` payload typed as T. Throws on non-2xx
+     * or success=false.
+     */
+    async get(path, query) {
+        const url = new URL(this.baseURL + path);
+        if (query) {
+            for (const [k, v] of Object.entries(query)) {
+                if (v !== undefined && v !== '')
+                    url.searchParams.set(k, v);
+            }
+        }
+        const res = await this.fetch(url, { method: 'GET' });
+        return this.parseEnvelope(res);
+    }
+    /**
+     * Authenticated JSON POST. body is JSON.stringified; response decoded
+     * as envelope.
+     */
+    async post(path, body) {
+        const res = await this.fetch(new URL(this.baseURL + path), {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body ?? {}),
+        });
+        return this.parseEnvelope(res);
+    }
+    /**
+     * Authenticated POST with raw binary body. Used for the Phase 12
+     * context upload (`POST /v1/platform/deployments/custom/contexts`)
+     * which accepts a gzip tarball as the raw body.
+     */
+    async postRaw(path, contentType, bytes) {
+        const res = await this.fetch(new URL(this.baseURL + path), {
+            method: 'POST',
+            headers: { 'Content-Type': contentType },
+            body: bytes,
+        });
+        return this.parseEnvelope(res);
+    }
+    async fetch(url, init) {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(url, {
+                ...init,
+                headers: {
+                    Accept: 'application/json',
+                    'X-API-Key': this.apiKey,
+                    'X-API-Secret': this.apiSecret,
+                    'User-Agent': `impreza-mcp/${VERSION}`,
+                    ...(init.headers ?? {}),
+                },
+                signal: ctrl.signal,
+            });
+            return res;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async parseEnvelope(res) {
+        const text = await res.text();
+        let env;
+        try {
+            env = text ? JSON.parse(text) : {};
+        }
+        catch {
+            throw new Error(`HTTP ${res.status}: non-JSON response (${text.slice(0, 200)})`);
+        }
+        if (!res.ok || env.success === false || env.error) {
+            const code = env.error?.code ?? `HTTP_${res.status}`;
+            const msg = env.error?.message ?? `request failed (HTTP ${res.status})`;
+            const reqId = env.meta?.request_id ? ` [req=${env.meta.request_id}]` : '';
+            throw new Error(`${code}: ${msg}${reqId}`);
+        }
+        return env.data ?? undefined;
+    }
+}
+/** Hard-coded version stamp — bumped per release. */
+const VERSION = '0.1.0';
+// ─────────────────────────────────────────────────────────────────────
+// Tarball helper — used by the Dockerfile-mode upload path
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Tar + gzip the given project directory into a temp file, return
+ * the bytes + the temp path (so the caller can delete it after
+ * upload). Excludes the usual suspects (.git, node_modules,
+ * __pycache__, etc.) baked into the same list the Go CLI uses.
+ *
+ * The tar is rooted at the project dir contents (entries are
+ * `Dockerfile`, `main.go`, etc., not `proj/Dockerfile`), matching
+ * what the agent's extractor expects.
+ */
+export async function tarProjectDir(projectDir) {
+    const info = await stat(projectDir);
+    if (!info.isDirectory()) {
+        throw new Error(`${projectDir} is not a directory`);
+    }
+    const tmpPath = join(tmpdir(), `impreza-mcp-ctx-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.tar.gz`);
+    // Stream-tar into the temp file, then read back as bytes.
+    await new Promise((resolve, reject) => {
+        const out = createWriteStream(tmpPath);
+        out.on('error', reject);
+        out.on('finish', resolve);
+        tar
+            .create({
+            gzip: true,
+            cwd: projectDir,
+            // Exclude common noise that bloats the upload or contains
+            // host-specific paths. Match basenames against the bake-in set.
+            filter: (path) => !isExcluded(path),
+        }, ['.'])
+            .pipe(out);
+    });
+    const bytes = await readFile(tmpPath);
+    return {
+        bytes,
+        sizeBytes: bytes.byteLength,
+        cleanup: async () => {
+            try {
+                await unlink(tmpPath);
+            }
+            catch {
+                /* best effort */
+            }
+        },
+    };
+}
+const EXCLUDED_DIRS = new Set(['.git', '.svn', '.hg', '.bzr', 'node_modules', '__pycache__', '.venv', 'venv', '.impreza']);
+const EXCLUDED_FILES = new Set(['.DS_Store', 'Thumbs.db']);
+function isExcluded(relPath) {
+    const normalized = relPath.replace(/^\.[\\/]+/, '').replace(/\\/g, '/');
+    const parts = normalized.split('/').filter((p) => p && p !== '.');
+    for (const p of parts) {
+        if (EXCLUDED_DIRS.has(p))
+            return true;
+    }
+    const base = parts[parts.length - 1] ?? '';
+    if (EXCLUDED_FILES.has(base))
+        return true;
+    if (base.endsWith('.pyc'))
+        return true;
+    return false;
+}
+/** Lowercase hex sha256 of the given bytes. */
+export function sha256Hex(bytes) {
+    return createHash('sha256').update(bytes).digest('hex');
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/server.js

@@ -0,0 +1,433 @@
+#!/usr/bin/env node
+//
+// impreza-mcp — Model Context Protocol server for Impreza Host.
+//
+// Boots over stdio so AI tools (Claude Code, Cursor, Codex, Continue,
+// Zed, ...) can attach via the standard `command + args` MCP transport.
+// Auth is the customer's Impreza API key + secret, passed in via env
+// (`IMPREZA_API_KEY` / `IMPREZA_API_SECRET`).
+//
+// Iterations:
+//   A — list servers/apps/deployments, deploy_custom (3 modes), uninstall.
+//   B — logs / restart / change_domain / add_onion /
+//       deploy_catalog_app + `setup --tool ...` wizard.
+//
+// Subcommands:
+//   (no args)                 — boot the MCP server over stdio (default)
+//   setup --tool <name>       — print ready-to-paste AI-tool config snippet
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { ImprezaClient, tarProjectDir, } from './client.js';
+import { runSetup } from './setup.js';
+// ─────────────────────────────────────────────────────────────────────
+// Subcommand dispatch — `setup` short-circuits before env validation.
+// ─────────────────────────────────────────────────────────────────────
+const sub = process.argv[2];
+if (sub === 'setup') {
+    runSetup(process.argv.slice(3));
+    // runSetup() calls process.exit; this line never executes.
+}
+if (sub === '--help' || sub === '-h' || sub === 'help') {
+    console.log('Usage:');
+    console.log('  impreza-mcp                       Run the MCP server over stdio (default).');
+    console.log('                                    Requires IMPREZA_API_KEY + IMPREZA_API_SECRET env.');
+    console.log('  impreza-mcp setup --tool <name>   Print a ready-to-paste config snippet.');
+    console.log('                                    Tools: claude-code | cursor | continue | zed | codex-cli');
+    console.log('  impreza-mcp --version             Print version.');
+    process.exit(0);
+}
+if (sub === '--version' || sub === '-V' || sub === 'version') {
+    console.log('impreza-mcp 0.1.0');
+    process.exit(0);
+}
+// ─────────────────────────────────────────────────────────────────────
+// Env validation
+// ─────────────────────────────────────────────────────────────────────
+const envSchema = z.object({
+    IMPREZA_API_KEY: z.string().min(8, 'IMPREZA_API_KEY must be set (starts with imp_)'),
+    IMPREZA_API_SECRET: z.string().min(16, 'IMPREZA_API_SECRET must be set'),
+    IMPREZA_BASE_URL: z.string().url().default('https://api.imprezahost.com'),
+});
+let cfg;
+try {
+    cfg = envSchema.parse(process.env);
+}
+catch (err) {
+    // Log to stderr (stdout is the MCP transport stream — must stay clean).
+    if (err instanceof z.ZodError) {
+        console.error('[impreza-mcp] env validation failed:');
+        for (const issue of err.issues) {
+            console.error(`  - ${issue.path.join('.')}: ${issue.message}`);
+        }
+        console.error('\nSet IMPREZA_API_KEY + IMPREZA_API_SECRET in your MCP config env (see README).');
+    }
+    else {
+        console.error('[impreza-mcp] env parse error:', err);
+    }
+    process.exit(2);
+}
+const impreza = new ImprezaClient({
+    baseURL: cfg.IMPREZA_BASE_URL,
+    apiKey: cfg.IMPREZA_API_KEY,
+    apiSecret: cfg.IMPREZA_API_SECRET,
+});
+// ─────────────────────────────────────────────────────────────────────
+// MCP server setup
+// ─────────────────────────────────────────────────────────────────────
+const server = new Server({ name: 'impreza-mcp', version: '0.1.0' }, { capabilities: { tools: {} } });
+// Tool definitions — each one wraps an Impreza REST call. JSON Schema
+// here is what the AI sees in its tool catalog; the description should
+// be rich enough that the LLM picks the right tool without hand-holding.
+const TOOLS = [
+    {
+        name: 'impreza_list_servers',
+        description: 'List every Impreza-managed VPS the customer owns (and any external bring-your-own server they registered). ' +
+            'Use to find the right `agent_id` before calling `impreza_deploy_custom`. ' +
+            'Returns hostname + IP + status (online/offline/draining/revoked) for each.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'impreza_list_apps',
+        description: 'List apps available in the Impreza curated catalog (Vaultwarden, n8n, Nextcloud, etc.). ' +
+            'These are pre-packaged manifests the customer can install with one click. ' +
+            'For non-catalog apps the customer built themselves, use `impreza_deploy_custom` instead.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                search: { type: 'string', description: 'Optional case-insensitive substring filter on name/category/tags.' },
+                category: { type: 'string', description: 'Optional category filter (e.g. "media", "productivity").' },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'impreza_list_deployments',
+        description: 'List the customer\'s currently-installed app deployments (catalog + custom). ' +
+            'Optionally narrow to a single server via `agent_id`. ' +
+            'Use to confirm what\'s running before adding more, or to find a `deployment_id` to uninstall/restart.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Optional: narrow to a single server.' },
+                status: { type: 'string', description: 'Optional: filter by status (running, failed, installing, ...).' },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'impreza_deploy_custom',
+        description: 'Deploy a custom (non-catalog) app to an Impreza VPS. Three modes — pick exactly one:\n' +
+            '  • `mode: "image"` — public Docker image URL (`image: "ghcr.io/user/app:tag"`).\n' +
+            '  • `mode: "dockerfile"` — local project directory with a Dockerfile (`dir: "/abs/path/to/project"`). ' +
+            'The MCP server tars + uploads it; the agent runs `docker build` locally on the VPS.\n' +
+            '  • `mode: "manifest"` — a full docker-compose manifest object (advanced; same schema as catalog apps).\n' +
+            'Always required: `name`, `agent_id`. Use `impreza_list_servers` to find a valid `agent_id`.\n' +
+            'When the customer says "deploy this" with a project open, Dockerfile mode is the right choice.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Per-account-unique deploy name (3-100 chars, [a-z0-9_-]).' },
+                agent_id: { type: 'string', description: 'Target VPS agent_id (from impreza_list_servers).' },
+                mode: { type: 'string', enum: ['image', 'dockerfile', 'manifest'], description: 'Source mode.' },
+                domain: { type: 'string', description: 'Public hostname. Omit when `onion: true` for an onion-only deploy.' },
+                onion: { type: 'boolean', description: 'Also publish a Tor v3 hidden service. Default false.' },
+                cpus: { type: 'number', description: 'CPU limit (cores; 1.0 = one core). Default 1.0 server-side.' },
+                memory_mb: { type: 'number', description: 'Memory limit in MB. Default 512 server-side.' },
+                target_port: { type: 'number', description: 'Port the container listens on (default 80).' },
+                vars: { type: 'object', description: 'Environment variables to inject into the container.' },
+                image: { type: 'string', description: 'Required when mode=image. Public Docker image reference.' },
+                dir: { type: 'string', description: 'Required when mode=dockerfile. Absolute path to the project directory.' },
+                dockerfile_path: { type: 'string', description: 'Optional Dockerfile path relative to dir (default "Dockerfile").' },
+                manifest: { type: 'object', description: 'Required when mode=manifest. Full app manifest object.' },
+            },
+            required: ['name', 'agent_id', 'mode'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'impreza_uninstall_deployment',
+        description: 'Uninstall a deployment (catalog or custom) by `deployment_id`. ' +
+            'Set `purge_data: true` to also wipe the deployment\'s data volume. ' +
+            'Idempotent — calling on an already-uninstalled deployment is a no-op success.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                deployment_id: { type: 'string', description: 'The dpl_... id to remove.' },
+                purge_data: { type: 'boolean', description: 'Wipe the data volume too. Default false.' },
+            },
+            required: ['deployment_id'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'impreza_get_logs',
+        description: 'Fetch the last N lines of container logs for a deployment. Synchronous — the server enqueues a log-tail command for the agent, then waits up to ~25 seconds for the chunks to come back. Use this to debug a failed deploy (`impreza_list_deployments` showed last_error) or to inspect a running app\'s output.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                deployment_id: { type: 'string', description: 'The dpl_... id to tail.' },
+                lines: { type: 'number', description: 'Number of trailing lines (1-5000, default 200).' },
+                since_seconds: { type: 'number', description: 'Only logs from the last N seconds. Default 0 = no limit.' },
+            },
+            required: ['deployment_id'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'impreza_restart_deployment',
+        description: 'Restart a deployment\'s docker-compose stack (non-destructive). The container is stopped + started; data volumes preserved. Status flips to `installing` briefly then back to `running`. Works for both catalog and custom deployments.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                deployment_id: { type: 'string', description: 'The dpl_... id to restart.' },
+            },
+            required: ['deployment_id'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'impreza_change_domain',
+        description: 'Re-route a RUNNING deployment to a new clearnet hostname without touching its container or data. The agent regenerates its Caddy fragment + reloads zero-downtime; Let\'s Encrypt issues a fresh cert on the first hit. Use to migrate from an auto-subdomain to a custom domain, or vice-versa, or just to rename. Deployment must be in status=running (Phase 9.19).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                deployment_id: { type: 'string', description: 'The dpl_... id to re-route.' },
+                domain: { type: 'string', description: 'New clearnet hostname (no scheme). Must differ from the current one.' },
+            },
+            required: ['deployment_id', 'domain'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'impreza_add_onion',
+        description: 'Add a Tor v3 hidden service (.onion mirror) to a deployment that\'s currently running clearnet-only. The agent provisions Tor + publishes the hidden service alongside the existing clearnet route. Useful when the customer realized post-install that they wanted Tor exposure. The .onion address is persisted on the deployment row. Catalog deployments must declare `supports.onion: true`; for custom deployments this is always supported (Phase 89).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                deployment_id: { type: 'string', description: 'The dpl_... id to extend.' },
+            },
+            required: ['deployment_id'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'impreza_deploy_catalog_app',
+        description: 'Install an app from the Impreza catalog (Vaultwarden, n8n, Nextcloud, etc.) on a target VPS. Use `impreza_list_apps` to discover available names. Pair with `impreza_list_servers` to find the right `agent_id`. Variables specific to the app (e.g. `signups_allowed` for Vaultwarden) go in `vars`. For non-catalog apps the customer built themselves, use `impreza_deploy_custom` instead.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                app_name: { type: 'string', description: 'Catalog app name (e.g. "vaultwarden").' },
+                agent_id: { type: 'string', description: 'Target VPS agent_id.' },
+                app_version: { type: 'string', description: 'Optional pinned version. Default: latest published.' },
+                domain: { type: 'string', description: 'Public hostname for clearnet TLS. Omit + set onion:true for onion-only.' },
+                onion: { type: 'boolean', description: 'Also publish a Tor v3 hidden service mirror.' },
+                vars: { type: 'object', description: 'App-specific manifest variables (KEY → value).' },
+            },
+            required: ['app_name', 'agent_id'],
+            additionalProperties: false,
+        },
+    },
+];
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: rawArgs } = req.params;
+    const args = (rawArgs ?? {});
+    try {
+        switch (name) {
+            case 'impreza_list_servers':
+                return toResult(await impreza.get('/v1/platform/servers'));
+            case 'impreza_list_apps': {
+                const query = {};
+                if (typeof args.search === 'string')
+                    query.search = args.search;
+                if (typeof args.category === 'string')
+                    query.category = args.category;
+                return toResult(await impreza.get('/v1/platform/apps', query));
+            }
+            case 'impreza_list_deployments': {
+                const query = {};
+                if (typeof args.agent_id === 'string')
+                    query.agent_id = args.agent_id;
+                if (typeof args.status === 'string')
+                    query.status = args.status;
+                const [catalog, custom] = await Promise.all([
+                    impreza.get('/v1/platform/deployments', query),
+                    impreza
+                        .get('/v1/platform/deployments/custom', query)
+                        // Custom is best-effort — if the endpoint isn't ready on a
+                        // given control plane, surface catalog only rather than
+                        // failing the whole tool call.
+                        .catch(() => ({ deployments: [], total: 0 })),
+                ]);
+                return toResult({
+                    deployments: [...catalog.deployments, ...custom.deployments],
+                    total: catalog.total + custom.total,
+                    catalog_count: catalog.total,
+                    custom_count: custom.total,
+                });
+            }
+            case 'impreza_deploy_custom':
+                return toResult(await deployCustom(args));
+            case 'impreza_uninstall_deployment': {
+                const dep = String(args.deployment_id ?? '');
+                if (!dep)
+                    return toError('deployment_id is required');
+                const purge = args.purge_data === true;
+                const body = { purge_data: purge, confirm: true };
+                return toResult(await impreza.post(`/v1/platform/deployments/${encodeURIComponent(dep)}/uninstall`, body));
+            }
+            case 'impreza_get_logs': {
+                const dep = String(args.deployment_id ?? '');
+                if (!dep)
+                    return toError('deployment_id is required');
+                const body = {};
+                if (typeof args.lines === 'number')
+                    body.lines = args.lines;
+                if (typeof args.since_seconds === 'number')
+                    body.since_seconds = args.since_seconds;
+                return toResult(await impreza.post(`/v1/platform/deployments/${encodeURIComponent(dep)}/logs`, body));
+            }
+            case 'impreza_restart_deployment': {
+                const dep = String(args.deployment_id ?? '');
+                if (!dep)
+                    return toError('deployment_id is required');
+                return toResult(await impreza.post(`/v1/platform/deployments/${encodeURIComponent(dep)}/restart`, {}));
+            }
+            case 'impreza_change_domain': {
+                const dep = String(args.deployment_id ?? '');
+                const newDomain = String(args.domain ?? '');
+                if (!dep)
+                    return toError('deployment_id is required');
+                if (!newDomain)
+                    return toError('domain is required');
+                return toResult(await impreza.post(`/v1/platform/deployments/${encodeURIComponent(dep)}/domain`, { domain: newDomain }));
+            }
+            case 'impreza_add_onion': {
+                const dep = String(args.deployment_id ?? '');
+                if (!dep)
+                    return toError('deployment_id is required');
+                return toResult(await impreza.post(`/v1/platform/deployments/${encodeURIComponent(dep)}/onion/add`, {}));
+            }
+            case 'impreza_deploy_catalog_app': {
+                const appName = String(args.app_name ?? '');
+                const agentId = String(args.agent_id ?? '');
+                if (!appName)
+                    return toError('app_name is required');
+                if (!agentId)
+                    return toError('agent_id is required');
+                const body = { app_name: appName, agent_id: agentId };
+                if (typeof args.app_version === 'string')
+                    body.app_version = args.app_version;
+                if (typeof args.domain === 'string')
+                    body.domain = args.domain;
+                if (typeof args.onion === 'boolean')
+                    body.onion = args.onion;
+                if (args.vars && typeof args.vars === 'object')
+                    body.vars = args.vars;
+                return toResult(await impreza.post('/v1/platform/deployments', body));
+            }
+            default:
+                return toError(`unknown tool: ${name}`);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return toError(msg);
+    }
+});
+async function deployCustom(args) {
+    const name = String(args.name ?? '');
+    const agentId = String(args.agent_id ?? '');
+    const mode = String(args.mode ?? '');
+    if (!name || !agentId || !mode) {
+        throw new Error('name, agent_id, and mode are required');
+    }
+    const body = { name, agent_id: agentId, mode };
+    if (typeof args.domain === 'string')
+        body.domain = args.domain;
+    if (typeof args.onion === 'boolean')
+        body.onion = args.onion;
+    if (typeof args.cpus === 'number')
+        body.cpus = args.cpus;
+    if (typeof args.memory_mb === 'number')
+        body.memory_mb = args.memory_mb;
+    if (typeof args.target_port === 'number')
+        body.target_port = args.target_port;
+    if (args.vars && typeof args.vars === 'object')
+        body.vars = args.vars;
+    let traceTail = '';
+    switch (mode) {
+        case 'image':
+            if (typeof args.image !== 'string' || !args.image) {
+                throw new Error('mode=image requires `image` (public registry reference)');
+            }
+            body.image = args.image;
+            break;
+        case 'dockerfile': {
+            if (typeof args.dir !== 'string' || !args.dir) {
+                throw new Error('mode=dockerfile requires `dir` (absolute path to the project directory)');
+            }
+            // Tar locally + upload to /custom/contexts → get back context_id.
+            const packed = await tarProjectDir(args.dir);
+            try {
+                const upload = await impreza.postRaw('/v1/platform/deployments/custom/contexts', 'application/gzip', packed.bytes);
+                body.context_id = upload.context_id;
+                if (typeof args.dockerfile_path === 'string' && args.dockerfile_path && args.dockerfile_path !== 'Dockerfile') {
+                    body.dockerfile_path = args.dockerfile_path;
+                }
+                traceTail = ` (uploaded ${packed.sizeBytes} B → ${upload.context_id})`;
+            }
+            finally {
+                await packed.cleanup();
+            }
+            break;
+        }
+        case 'manifest':
+            if (!args.manifest || typeof args.manifest !== 'object') {
+                throw new Error('mode=manifest requires `manifest` (object with runtime.type + runtime.compose_yaml)');
+            }
+            body.manifest = args.manifest;
+            break;
+        default:
+            throw new Error(`unknown mode "${mode}" (expected image / dockerfile / manifest)`);
+    }
+    const created = await impreza.post('/v1/platform/deployments/custom', body);
+    if (traceTail) {
+        return { ...created, _trace: created.id + traceTail };
+    }
+    return created;
+}
+// ─────────────────────────────────────────────────────────────────────
+// Result shape — MCP wants either content[] or isError + content[]
+// ─────────────────────────────────────────────────────────────────────
+function toResult(payload) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+    };
+}
+function toError(message) {
+    return {
+        content: [{ type: 'text', text: message }],
+        isError: true,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────
+// Boot
+// ─────────────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Stay alive until stdin closes — the AI tool manages the process
+    // lifecycle, we just answer requests on demand.
+}
+main().catch((err) => {
+    console.error('[impreza-mcp] fatal:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/setup.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Run the wizard. Argv passed in is everything AFTER the `setup`
+ * subcommand (so `--tool claude-code ...`). Exits the process on
+ * completion (zero for success, non-zero on bad input).
+ */
+export declare function runSetup(argv: readonly string[]): never;

package/dist/setup.js

@@ -0,0 +1,215 @@
+// `npx impreza-mcp setup --tool <name>` wizard.
+//
+// Generates the ready-to-paste MCP config snippet for whatever AI tool
+// the customer is configuring, plus the file path they should drop it
+// into and the post-config step (almost always "restart the AI tool").
+//
+// No filesystem mutations. The wizard prints to stdout; the customer
+// pastes manually. This avoids the bad failure mode where we silently
+// corrupt an existing config that already has other MCP servers.
+//
+// Supported tools (`--tool` values):
+//
+//   claude-code   — Anthropic Claude Desktop / Claude Code
+//   cursor        — Cursor
+//   continue      — Continue (VS Code / JetBrains)
+//   zed           — Zed editor
+//   codex-cli     — OpenAI Codex CLI
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+const SUPPORTED = ['claude-code', 'cursor', 'continue', 'zed', 'codex-cli'];
+const SERVER_NAME = 'impreza';
+const NPX_COMMAND = 'npx';
+const NPX_ARGS = ['-y', 'impreza-mcp'];
+/**
+ * Run the wizard. Argv passed in is everything AFTER the `setup`
+ * subcommand (so `--tool claude-code ...`). Exits the process on
+ * completion (zero for success, non-zero on bad input).
+ */
+export function runSetup(argv) {
+    const opts = parseFlags(argv);
+    if (opts.help) {
+        printHelp();
+        process.exit(0);
+    }
+    const tool = opts.tool;
+    if (!tool) {
+        console.error('error: --tool is required');
+        console.error('');
+        printHelp();
+        process.exit(2);
+    }
+    if (!SUPPORTED.includes(tool)) {
+        console.error(`error: unknown tool "${tool}"`);
+        console.error(`supported: ${SUPPORTED.join(', ')}`);
+        process.exit(2);
+    }
+    const snippet = renderSnippet(tool);
+    const path = configPath(tool);
+    const restartHint = restartInstruction(tool);
+    console.log(`# impreza-mcp setup — ${tool}\n`);
+    console.log(`Add the following block to ${path === null ? 'your AI tool\'s MCP config file' : path}:\n`);
+    console.log(snippet);
+    console.log('');
+    console.log('Then:');
+    let step = 1;
+    if (path === null) {
+        console.log(`  ${step++}. consult the tool's docs for the exact config file path`);
+    }
+    console.log(`  ${step++}. replace \`imp_...\` / the secret with your real Impreza API key + secret`);
+    console.log("     (clientarea → API Keys; whitelist this machine's IP)");
+    console.log(`  ${step++}. ${restartHint}`);
+    console.log('');
+    console.log('Verify: ask your AI to run `impreza_list_servers`. It should list your VPSes.');
+    process.exit(0);
+}
+function parseFlags(argv) {
+    const out = { help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--help' || a === '-h')
+            out.help = true;
+        else if (a === '--tool') {
+            const next = argv[i + 1];
+            if (!next) {
+                console.error('error: --tool requires a value');
+                process.exit(2);
+            }
+            out.tool = next;
+            i++;
+        }
+        else if (a?.startsWith('--tool=')) {
+            out.tool = a.slice('--tool='.length);
+        }
+        else {
+            console.error(`error: unknown flag "${a}"`);
+            process.exit(2);
+        }
+    }
+    return out;
+}
+function printHelp() {
+    console.log('Usage: npx impreza-mcp setup --tool <name>');
+    console.log('');
+    console.log('Supported tools:');
+    console.log('  claude-code   Anthropic Claude Desktop / Claude Code');
+    console.log('  cursor        Cursor');
+    console.log('  continue      Continue (VS Code / JetBrains)');
+    console.log('  zed           Zed editor');
+    console.log('  codex-cli     OpenAI Codex CLI');
+    console.log('');
+    console.log('Example:');
+    console.log('  npx impreza-mcp setup --tool claude-code');
+}
+// ─────────────────────────────────────────────────────────────────────
+// Per-tool config snippet generators
+// ─────────────────────────────────────────────────────────────────────
+function renderSnippet(tool) {
+    switch (tool) {
+        case 'claude-code':
+        case 'cursor':
+            // Both speak the standard `mcpServers` shape.
+            return jsonBlock({
+                mcpServers: {
+                    [SERVER_NAME]: stdioCommand(),
+                },
+            });
+        case 'continue':
+            return jsonBlock({
+                experimental: {
+                    modelContextProtocolServers: [
+                        {
+                            transport: {
+                                type: 'stdio',
+                                command: NPX_COMMAND,
+                                args: NPX_ARGS,
+                                env: envBlock(),
+                            },
+                        },
+                    ],
+                },
+            });
+        case 'zed':
+            return jsonBlock({
+                context_servers: {
+                    [SERVER_NAME]: {
+                        command: {
+                            path: NPX_COMMAND,
+                            args: NPX_ARGS,
+                            env: envBlock(),
+                        },
+                    },
+                },
+            });
+        case 'codex-cli':
+            // Codex CLI's MCP config uses the same `mcpServers` shape as
+            // Claude / Cursor, with a slightly different file path. Same
+            // JSON snippet — only the destination differs.
+            return jsonBlock({
+                mcpServers: {
+                    [SERVER_NAME]: stdioCommand(),
+                },
+            });
+    }
+}
+function stdioCommand() {
+    return {
+        command: NPX_COMMAND,
+        args: NPX_ARGS,
+        env: envBlock(),
+    };
+}
+function envBlock() {
+    return {
+        IMPREZA_API_KEY: 'imp_REPLACE_ME',
+        IMPREZA_API_SECRET: 'REPLACE_ME',
+    };
+}
+function jsonBlock(value) {
+    return JSON.stringify(value, null, 2);
+}
+// ─────────────────────────────────────────────────────────────────────
+// Per-tool config-file paths (informational, never written)
+// ─────────────────────────────────────────────────────────────────────
+function configPath(tool) {
+    const home = homedir();
+    const plat = platform();
+    switch (tool) {
+        case 'claude-code':
+            if (plat === 'darwin')
+                return join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+            if (plat === 'win32')
+                return join(process.env.APPDATA ?? join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+            return join(home, '.config', 'Claude', 'claude_desktop_config.json');
+        case 'cursor':
+            return join(home, '.cursor', 'mcp.json');
+        case 'continue':
+            return join(home, '.continue', 'config.json');
+        case 'zed':
+            if (plat === 'darwin')
+                return join(home, '.config', 'zed', 'settings.json');
+            if (plat === 'win32')
+                return join(process.env.APPDATA ?? join(home, 'AppData', 'Roaming'), 'Zed', 'settings.json');
+            return join(home, '.config', 'zed', 'settings.json');
+        case 'codex-cli':
+            // Codex CLI's MCP config lives in `~/.codex/config.toml` OR
+            // a parallel JSON file depending on version. The customer
+            // knows which they have; don't guess.
+            return null;
+    }
+}
+function restartInstruction(tool) {
+    switch (tool) {
+        case 'claude-code':
+            return 'fully quit + re-open Claude (Cmd/Ctrl+Q, then launch again — reload-on-MCP-config-change isn\'t supported)';
+        case 'cursor':
+            return 'quit + re-open Cursor (the MCP servers re-launch on startup)';
+        case 'continue':
+            return 'reload your editor window (VS Code: Cmd/Ctrl+Shift+P → "Developer: Reload Window"; JetBrains: restart)';
+        case 'zed':
+            return 'quit + re-open Zed';
+        case 'codex-cli':
+            return 'restart any running codex session (the MCP server attaches per-session)';
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "impreza-mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for Impreza Host — lets Claude Code / Cursor / Codex / Continue / Zed deploy customer-built apps to managed Impreza VPSes without leaving the chat.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "impreza-mcp": "dist/server.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "watch": "tsc -p tsconfig.json --watch",
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepare": "npm run build"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "homepage": "https://github.com/imprezahost/impreza-mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/imprezahost/impreza-mcp.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "impreza",
+    "claude",
+    "cursor",
+    "deploy",
+    "docker",
+    "self-hosted"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "tar": "^7.4.3",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/tar": "^6.1.13",
+    "@typescript-eslint/eslint-plugin": "^8.18.0",
+    "@typescript-eslint/parser": "^8.18.0",
+    "eslint": "^9.16.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  }
+}