Dasemu fb59d422a2
All checks were successful
CI / test (push) Successful in 31s
feat: support optional per-installation Basic Auth on the MCP proxy
Lets a client still using Basic Auth credentials (e.g. against the
previous nginx + htpasswd setup) keep working without switching to a
bearer token immediately. Bearer auth remains the default and the
only option when no Basic Auth credentials are configured.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-10-08 05:05:11 +02:00

remote-mcp-manager

Self-hosted manager for MCP servers: install one from a GitHub repo URL, configure its env vars, build it with Nixpacks (no Dockerfile needed in the source repo), run it in a container, and get back an authenticated https://<your-domain>/mcp/<slug> URL guarded by a bearer token.

Quick start (production, Docker)

cp .env.example .env   # fill in ADMIN_PASSWORD, SESSION_SECRET, MASTER_KEY, PUBLIC_BASE_URL
docker compose up -d --build

Put your own reverse proxy (nginx, etc.) in front of port 3000 for TLS and your public domain.

Local development (Podman)

Requires nixpacks and a docker CLI pointed at your Podman socket (e.g. via the podman-docker package) on your PATH.

npm install
DOCKER_SOCKET_PATH=/run/user/$(id -u)/podman/podman.sock \
DATA_DIR=./data MASTER_KEY=... SESSION_SECRET=... ADMIN_PASSWORD=... \
  npm run dev:server

Because rootless Podman isolates the host network namespace from the container bridge, the manager itself must run as a container attached to mcp-net to reach the MCP containers it manages — running it directly on the host only works for routes that don't need to reach a sibling container (e.g. /health, /api/auth).

Tests

npm test

Runs the apps/server unit test suite (vitest): the secrets encryption round-trip, the Nixpacks runtime-version detection, the admin-session middleware, and the installations state machine against a temporary SQLite DB. .gitea/workflows/ci.yml runs the same build and test steps on every push, provided this repo's Gitea instance has Actions enabled with a runner.

Known limitations

  • Nixpacks needs a dependency manifest (requirements.txt/pyproject.toml for Python, package.json for Node) in the installed repo. Repos without one will fail to build; the full build log is always visible in the UI to diagnose this.
  • Every installed container gets the same memory/CPU caps (CONTAINER_MEMORY_MB, CONTAINER_CPUS), no per-installation override yet.
  • No multi-user support — single operator only.
  • Builds run one at a time.

See LESSONS.md for operational gotchas found while building and running this (Nixpacks runtime-version mismatches, Podman networking, SELinux, etc.).

Description
A self-hosted Docker manager for deploying MCP servers (yours or third-party) straight from a GitHub repository, with automatic builds (Nixpacks), environment variable configuration, and a reverse proxy that issues an authenticated token link, all from an admin panel.
Readme GPL-3.0 225 KiB
Languages
TypeScript 79.8%
CSS 17.2%
Dockerfile 2.2%
HTML 0.8%