impreza-mcp

impreza-mcp

Model Context Protocol server forImpreza Host. Lets AI coding tools (ClaudeCode, Cursor, Codex CLI, Continue, Zed, ...) deploy customer-builtapps to managed Impreza VPSes without leaving the chat.

When you say "deploy this for me" to Claude with this MCP serverloaded, Claude calls impreza_deploy_custom directly — packages yourproject, uploads it, builds + runs on your Impreza VPS, and reportsback the URL.

No-install alternative: if your AI client supports remote MCPconnectors (e.g. Claude), you can skip this package and add the hostedconnector https://mcp.imprezahost.com/mcp instead — authorize in yourImpreza clientarea, no API key and no IP whitelist. It exposes the samefull toolset, gated by the scopes you grant on consent (read / deploy /manage). Install this package when you want a local server — e.g. to deploya project folder straight from your machine, which the hosted connector can't.

Status

Full surface live. All 32 tools shipped — app deployment (14) plusaccount + crypto balance, domains/DNS, and VPS lifecycle (18) — with a setupwizard that generates ready-to-paste config snippets for 5 AI tools.

Install + setup

Prerequisites

• Node ≥ 20
• An Impreza Host account with an API key + secret (clientarea →Impreza API). The key's IP factor is per-key: whitelist (default —add this machine's IP), tofu (trust-on-first-use — auto-pins thefirst IP), or keyonly (no IP factor)

One-shot via npx

No global install needed — npx impreza-mcp works.

Or install globally

npm install -g impreza-mcp

Get a ready-to-paste config snippet

The fastest path: ask the binary itself.

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 MCPconfig + the exact file path + the post-config step (usually "fullyquit + re-open the AI tool"). It does NOT write to disk — paste ityourself so you don't accidentally clobber an existing config withother 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):

{
  "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:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "impreza-mcp"],
          "env": {
            "IMPREZA_API_KEY": "imp_...",
            "IMPREZA_API_SECRET": "..."
          }
        }
      }
    ]
  }
}

Zed — add to your settings:

{
  "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, deployswith onion=true, reports the .onion address.

"What apps are running on my agent?" → callsimpreza_list_deployments filtered to the right server.

Auth + security

IMPREZA_API_KEY + IMPREZA_API_SECRET live in the AI tool's MCPconfig env — not in any file on disk owned by impreza-mcp itself.The MCP server holds the secret only in memory and only attaches itas HTTP request headers.

The API key's IP second factor is per-key: leave it on whitelist andadd this machine's IP, or pick tofu (auto-pins the first IP) orkeyonly (no IP factor) in your Impreza clientarea — so the whiteliststep is now optional. Tokens issued via the hosted OAuth connector arescoped and revocable under clientarea → Impreza API → Connected Apps.

Build

npm install
npm run build
# dist/server.js is the entry point

License

MIT — see LICENSE.