I
imprezahost/impreza-mcp
MCP server for Impreza Host: deploy custom apps to managed VPSes from your AI editor.
SECURITY.md ✓
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
- Copy the command above
- Paste it as one entry under
mcpServersinclaude_desktop_config.json— local servers take command + args (example: clients) - Restart your client
Remote endpoint (mcpServers - Claude Desktop / Cursor / Windsurf)
{
"mcpServers": {
"imprezahost-impreza-mcp": {
"url": "https://mcp.imprezahost.com/mcp"
}
}
}Paste this into the mcpServers config of Claude Desktop or Cursor. The endpoint comes from public evidence; we do not install or host it. Official Registry record: this endpoint lists no request headers. That is not the same as key-free - the project docs decide.
VS Code (.vscode/mcp.json - the key is servers, remote needs type: http)
{
"servers": {
"imprezahost-impreza-mcp": {
"type": "http",
"url": "https://mcp.imprezahost.com/mcp"
}
}
}VS Code differs from the other three: the top-level key is <code>servers</code> and a remote endpoint also needs <code>"type": "http"</code>. Paste into .vscode/mcp.json.
Claude Code (command line)
claude mcp add --transport http imprezahost-impreza-mcp https://mcp.imprezahost.com/mcp
Claude Code does not read a config file; add the server with this command.
Client config (built from the install command this repo gives)
{
"mcpServers": {
"imprezahost-impreza-mcp": {
"command": "npx",
"args": ["-y", "impreza-mcp"]
}
}
}Parsed from the README we fetched on 2026-10-26; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"imprezahost-impreza-mcp": {
"command": "npx",
"args": ["-y", "impreza-mcp"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio imprezahost-impreza-mcp -- npx -y impreza-mcp
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 0 ★ · imprezahost/impreza-mcp · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-10-23 · last seen 2026-11-14 · seen 26× · listed by 23 sources
- Score
- score 2,300 · 23 sources · mcp
- Install
npx -y impreza-mcp
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx -y impreza-mcp. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
imprezahost/impreza-mcp；first catalogued 2026-10-23；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.# impreza-mcp
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
Model Context Protocol server for
Impreza Host. 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 imprezadeploycustom directly — packages your
project, uploads it, builds + runs on your Impreza VPS, and reports
back the URL.
## Pair the local CLI
Generate a one-time code in clientarea under Impreza API → Connect an AI assistant, choosing the permissions the assistant needs. Run npx -y impreza-mcp login --code on the machine running the local MCP server. Codes expire after 10 minutes and can be used once.
The CLI exchanges the code at POST /v1/mcp/pair without sending any existing API credentials. It saves the returned key, secret, scopes and expiry in ~/.impreza/credentials.json; the code and secret are never printed. The directory uses mode 0700 and the file 0600 on POSIX. Windows uses a protected ACL granting access only to your account. The server reads this file automatically when neither credential environment variable is set. Explicit IMPREZAAPIKEY and IMPREZAAPISECRET take precedence together; partial environment credentials never use a saved counterpart.
Set IMPREZABASEURL before pairing for a different API endpoint. HTTPS is required; a v3 onion endpoint requires IMPREZAPROXY with an explicit SOCKS5 proxy and never falls back to a direct connection. The endpoint and proxy are saved with the credential. A different API URL refuses the saved credential. Pairing never follows redirects or retries a code automatically.
An existing credential file is never overwritten. Revoke an old paired key in clientarea before removing its file and pairing again. If an exchange or disk write fails, the code may already have been consumed: check and revoke the new key in clientarea before generating another code. Restart the AI client after pairing.
## Add a server you already have (0.53.0)
imprezaaddserver connects a server the customer already has (any Linux machine with root access and
outbound HTTPS, at any provider) and returns a one-line install command with a one-time token valid for 10 minutes.
The first external server is free on every account, with no plan and no balance; any active Impreza VPS moves the
account to Bundled (5 external servers). The token is shown once and only its hash is kept: if it is lost or
expires, call the tool again. An unused token holds the free slot until it expires, and new servers are limited
per day. label is optional plain text of up to 120 characters, counted as Unicode code points, the same way the
API counts them. For a managed Impreza VPS, use imprezainstallagent. Requires deploy scope.
The start-from-nothing skill asks first whether the customer already has a server, and describes the anonymous
lobby of the hosted connector: account creation plus reads of public information (docs search, the VPS offer and
quote, products, apps, manifest check, domain availability and prices).
Tool titles and descriptions follow the current API guidance: secret values are typed by the account owner in the
Impreza Host. 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 imprezadeploycustom directly — packages your
project, uploads it, builds + runs on your Impreza VPS, and reports
back the URL.
## Pair the local CLI
Generate a one-time code in clientarea under Impreza API → Connect an AI assistant, choosing the permissions the assistant needs. Run npx -y impreza-mcp login --code on the machine running the local MCP server. Codes expire after 10 minutes and can be used once.
The CLI exchanges the code at POST /v1/mcp/pair without sending any existing API credentials. It saves the returned key, secret, scopes and expiry in ~/.impreza/credentials.json; the code and secret are never printed. The directory uses mode 0700 and the file 0600 on POSIX. Windows uses a protected ACL granting access only to your account. The server reads this file automatically when neither credential environment variable is set. Explicit IMPREZAAPIKEY and IMPREZAAPISECRET take precedence together; partial environment credentials never use a saved counterpart.
Set IMPREZABASEURL before pairing for a different API endpoint. HTTPS is required; a v3 onion endpoint requires IMPREZAPROXY with an explicit SOCKS5 proxy and never falls back to a direct connection. The endpoint and proxy are saved with the credential. A different API URL refuses the saved credential. Pairing never follows redirects or retries a code automatically.
An existing credential file is never overwritten. Revoke an old paired key in clientarea before removing its file and pairing again. If an exchange or disk write fails, the code may already have been consumed: check and revoke the new key in clientarea before generating another code. Restart the AI client after pairing.
## Add a server you already have (0.53.0)
imprezaaddserver connects a server the customer already has (any Linux machine with root access and
outbound HTTPS, at any provider) and returns a one-line install command with a one-time token valid for 10 minutes.
The first external server is free on every account, with no plan and no balance; any active Impreza VPS moves the
account to Bundled (5 external servers). The token is shown once and only its hash is kept: if it is lost or
expires, call the tool again. An unused token holds the free slot until it expires, and new servers are limited
per day. label is optional plain text of up to 120 characters, counted as Unicode code points, the same way the
API counts them. For a managed Impreza VPS, use imprezainstallagent. Requires deploy scope.
The start-from-nothing skill asks first whether the customer already has a server, and describes the anonymous
lobby of the hosted connector: account creation plus reads of public information (docs search, the VPS offer and
quote, products, apps, manifest check, domain availability and prices).
Tool titles and descriptions follow the current API guidance: secret values are typed by the account owner in the
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/imprezahost-impreza-mcp/)
- Source
- awesome · https://github.com/imprezahost/impreza-mcp
- Browse by field
- MCP servers
- Listed by
- 23 independent sources
- added
- today
- Security policy
- the repository has
SECURITY.mdat its root (we checked that the file exists, not what it says)
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.