Self-host MetaMCP on a VPS
An MCP aggregator and gateway that groups many MCP servers behind one endpoint with auth, namespaces and middleware.
levelrail-cli templates install metamcp --name my-metamcpSpecification
- Status
- Listed
- Category
- AI
- Services
- db, metamcp
- Ports
- 12008
- Volumes
- 1
- Memory
- about 1 GiB
- arm64
- image published
- amd64
- image published
- Settings to fill in
- none
- License
- Permissive license, MIT
About MetaMCP
An MCP aggregator and gateway that groups many MCP servers behind one endpoint with auth, namespaces and middleware.
What it deploys
MetaMCP runs as 2 services in a single Compose app, listening on port 12008, with 1 named volume mount.
| Service | Image | Tag | Ports | Volumes |
|---|---|---|---|---|
| db | postgres | 16-alpine | none | pgdata -> /var/lib/postgresql/data |
| metamcp | ghcr.io/metatool-ai/metamcp | 2.4 | 12008 | none |
Before you install
- CPU architecture. arm64 listed. Every image lists linux/arm64 in its registry manifest. That is a manifest fact, not proof the app runs on Arm.
- Listed. It is in the catalog. Back up the data volume before changing an image tag.
Settings and environment
You do not have to fill in anything. 4 secrets are generated at deploy and stored encrypted. Values are never shown here.
| Service | Variable | Value |
|---|---|---|
| db | POSTGRES_DB | Preset by the template |
| db | POSTGRES_PASSWORD | Generated at deploy |
| db | POSTGRES_USER | Preset by the template |
| metamcp | APP_URL | Preset by the template |
| metamcp | BETTER_AUTH_SECRET | Generated at deploy |
| metamcp | DATABASE_URL | Generated at deploy |
| metamcp | NEXT_PUBLIC_APP_URL | Preset by the template |
| metamcp | POSTGRES_DB | Preset by the template |
| metamcp | POSTGRES_HOST | Preset by the template |
| metamcp | POSTGRES_PASSWORD | Generated at deploy |
| metamcp | POSTGRES_PORT | Preset by the template |
| metamcp | POSTGRES_USER | Preset by the template |
| metamcp | TRANSFORM_LOCALHOST_TO_DOCKER_INTERNAL | Preset by the template |
Install MetaMCP on a VPS
-
Install Levelrail on a fresh VPS
Run this as root on a Linux server (amd64 or arm64) with ports 80 and 443 reachable. The installer prints a setup link.
curl -fsSL https://levelrail.com/install.sh | sudo sh -
Sign in
Open the setup link, choose a password, then log the CLI in. The CLI install command is
curl -fsSL https://levelrail.com/install-cli.sh | shif the machine does not have it. See Getting started.levelrail-cli login --device -
Read the template
Shows the entry, including its full compose.yaml.
levelrail-cli templates get metamcp -
Install it
This template has an install form, so the CLI fills each setting from --env, a generated secret or its default.
levelrail-cli templates install metamcp --name my-metamcpTo put a service behind a domain at install, add
--domain SERVICE=HOST:levelrail-cli templates install metamcp --name my-metamcp --domain db=metamcp.example.com
Without a domain the app gets an sslip.io address. You can also deploy it from the dashboard: Apps, New app, Browse templates, then MetaMCP.
Docs and upstream
More in AI
- MindsDBA query layer that connects data sources and AI models so you can ask questions in SQL. MIT licensed. Includes the web editor and the HTTP API.
- MLflowTrack experiments, compare runs, and manage models with a self-hosted MLflow tracking server.
- n8n AI Starter Kitn8n wired to a local Ollama model and a Qdrant vector store, ready for private AI workflows.
- n8n MCPA Model Context Protocol server that gives AI assistants searchable n8n node documentation. MIT licensed. The bearer token is generated for you.
- New APIAn LLM gateway and AI asset management system that unifies many model providers.
- LocalAIA drop-in OpenAI-compatible API that runs language, image, and speech models on your own hardware.