Is mcphub still maintained?

Yes, active. Last change today. Latest release v1.2.3, yesterday.

Widely used. 2.7k stars, 1 years old. As with any download, get it from the official repo.

Assembly instructions

samanhappy/mcphub

Self-hosted MCP gateway and control plane for connecting, controlling, and operating MCP servers.

Node.jsVite#mcp#mcp-gateway#mcp-hub#mcp-router

Before you start

Is it free?: YesOpen source (Apache-2.0).
Still maintained?: Yes, activeLast change today. Latest release v1.2.3, yesterday.
Can I trust it?: Widely used2.7k stars, 1 years old. As with any download, get it from the official repo.

Difficulty: Involved
Time: 30 min or more
Stars: ★ 2,677
Activity: Updated this month

Saved setup from just now

Will it work on macOS?

Yes, with Docker on macOS

It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On macOS that means installing Docker Desktop first.

Your system

macOS Windows Linux

Start here

Website ↗mcphub.appThe project's own site.

Also: Docs ↗

Heads-upBuilding it yourself? It also needs PostgreSQL, Redis and 2 settings in .env.

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Docker

docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub

Docker

docker run -p 3000:3000 -v ./data:/app/data -e ADMIN_PASSWORD=your-secure-password samanhappy/mcphub

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 11 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js >=22.0.0runtime
1×Docker tool
1×pnpm pnpm@10.12.4package manager
1×PostgreSQL service
1×Redis service

2× settings in .env

PORT
NODE_ENV

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/samanhappy/mcphub/badge.svg)](https://gitmanual.com/samanhappy/mcphub)

Good to know

Monorepo (workspaces) — install from the repo root.
Dockerfile available (base image: python:3.13-slim-trixie).
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.

Details

License: Apache-2.0
Open issues: 14
Branch: main

package.json scripts (23)

db:setupnode dist/db/setup.js
buildpnpm backend:build && pnpm frontend:build
backend:buildtsc && node scripts/build-mcp-client.js
startnode dist/index.js
clitsx src/cli/main.ts
backend:devnode scripts/dev-backend.js
backend:debugnode scripts/dev-backend.js --inspect
linteslint .
formatprettier --write "src/**/*.ts"
testjest
test:replicassh scripts/test-replicas.sh
test:watchjest --watch
test:coveragejest --coverage
test:verbosejest --verbose
test:cijest --ci --coverage --watchAll=false
docs:validatenode scripts/validate-docs.js
frontend:devcd frontend && vite
frontend:buildcd frontend && vite build
frontend:typechecktsc --noEmit -p frontend/tsconfig.json
frontend:previewcd frontend && vite preview
devconcurrently "pnpm backend:dev" "pnpm frontend:dev"
debugconcurrently "pnpm backend:debug" "pnpm frontend:dev"
prepublishOnlynpm run build && node scripts/verify-dist.js

Files we read (11)

.env.example

.github/workflows/build.yml

.github/workflows/ci.yml

.github/workflows/npm-publish.yml

.github/workflows/release-notes.yml

.github/workflows/release.yml

Dockerfile

README.md

docs/installation.mdx

package.json

pnpm-workspace.yaml

1,028 files in the repo

Yes, with Docker on macOS

Start here

Run it with Docker

Did you get it running?

Still stuck? Get a written guide

More like mcphub that run on macOS