mcp-hub
Search and read academic papers from arXiv.
Perform web searches using the Brave Search API.
Manage Cloudflare DNS, pages, and other services.
Interact with Discord servers, messages, and channels.
Manage containers, images, volumes, and Docker resources.
Access GitHub repositories, issues, pull requests, actions, and code search.
Manage GitLab repositories, projects, and CI/CD (local tool).
Access and manage files on Google Drive.
Query and manage Grafana dashboards and alerts.
Manage Kubernetes clusters, deployments, and resources (local tool).
Manage issues, projects, and teams via Linear API.
Interact with S3-compatible object storage (MinIO).
Access and manage Notion workspaces and databases.
Utilize OpenAI models for text generation and analysis.
Query and manage PostgreSQL databases.
Query metrics and manage Prometheus monitoring.
Control headless Chrome for web scraping and automation.
Interact with Redis key-value store.
Track errors and performance via Sentry.
Send messages, manage channels, and interact with Slack workspace.
Query and manage SQLite databases.
Manage infrastructure as code with Terraform.
Search and read articles from Wikipedia.
Access computational knowledge via Wolfram Alpha.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-hubsearch GitHub for 'mcp-server' and fetch the top result"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Hub
Internal MCP (Model Context Protocol) server and AI tools platform for the homelab. Acts as a single gateway that aggregates dozens of upstream MCP servers — your AIs connect once and get access to everything.
How It Works
Claude Code / Claude Desktop / Any MCP Client
│
▼
┌───────────────┐
│ MCP Hub │ ← single SSE connection
│ (FastAPI) │
└──────┬────────┘
│
┌──────┴────────────────────────────────┐
│ │
▼ ▼ ▼ ▼
Local Tools GitHub MCP Brave MCP Wikipedia MCP
(GitLab,K8s, (stdio) (stdio) (stdio)
Homelab) ... ... ...Your AI connects to one endpoint and gets access to:
15 built-in local tools (GitLab, Kubernetes, Homelab)
30+ upstream MCP servers (search, databases, code, AI, monitoring, communication)
Related MCP server: MCP Gateway
Quick Start
cd ~/projects/homelab/mcp-hub
export MH_GITLAB_TOKEN=<your-gitlab-pat>
export MH_GITHUB_TOKEN=<your-github-token>
docker compose up -d
# Dashboard: http://localhost:8500
# MCP SSE: http://localhost:8500/mcp/sseConnect Your AI
Add to Claude Code settings.json:
{
"mcpServers": {
"mcp-hub": {
"type": "sse",
"url": "http://mcp-hub.steelcanvas.dev/mcp/sse"
}
}
}That's it. One connection, all tools.
Available Upstream Servers
Configured in upstreams.yaml. Enabled by default (no API key needed):
Server | Prefix | Description |
fetch |
| Fetch web pages, convert to markdown |
github |
| Repos, issues, PRs, actions, code search |
docker |
| Container, image, volume management |
arxiv |
| Search and read academic papers |
wikipedia |
| Search and read encyclopedia articles |
filesystem |
| Read, write, search files |
memory |
| Persistent knowledge graph |
time |
| Time, timezone conversions |
sequential-thinking |
| Structured reasoning |
Set an API key to enable:
Server | Prefix | Env Var |
Brave Search |
|
|
Tavily |
|
|
Exa |
|
|
Puppeteer |
| (just enable) |
PostgreSQL |
|
|
SQLite |
|
|
Redis |
|
|
Qdrant |
|
|
Wolfram Alpha |
|
|
Slack |
|
|
Discord |
|
|
Linear |
|
|
Notion |
|
|
HuggingFace |
|
|
OpenAI |
|
|
Prometheus |
|
|
Grafana |
|
|
Sentry |
|
|
S3/MinIO |
|
|
Cloudflare |
|
|
Terraform |
| (just enable) |
Google Drive |
| (OAuth setup) |
Adding Custom Upstream Servers
Edit upstreams.yaml:
upstreams:
# stdio-based (spawns a local process)
my-server:
transport: stdio
enabled: true
description: "My custom MCP server"
command: npx
args: ["-y", "my-mcp-package"]
env:
API_KEY: "${MH_MY_API_KEY}"
prefix: my
# SSE-based (connects to a remote HTTP endpoint)
remote-server:
transport: sse
enabled: true
description: "Remote MCP server"
url: "http://192.168.1.50:9000/mcp/sse"
headers:
Authorization: "Bearer ${MH_REMOTE_TOKEN}"
prefix: remoteAPI Endpoints
Endpoint | Description |
| Web dashboard |
| Health check (DB + proxy status) |
| All tools (local + proxied) with source |
| Tool invocation logs |
| Upstream connection status |
| Proxied tool name -> source mapping |
| Reconnect a specific upstream |
| MCP SSE endpoint |
| OpenAPI docs |
Architecture
mcp-hub/
├── mcp_hub/
│ ├── main.py # FastAPI app + dashboard + proxy lifecycle
│ ├── mcp_server.py # MCP server (FastMCP) with local tools
│ ├── config.py # Pydantic settings (MH_* env vars)
│ ├── database.py # SQLAlchemy async engine
│ ├── models/ # ORM models (ToolLog)
│ ├── tools/ # Built-in local tools
│ │ ├── gitlab_tools.py
│ │ ├── k8s_tools.py
│ │ └── homelab_tools.py
│ └── proxy/ # Upstream MCP proxy engine
│ ├── manager.py # Orchestrates connections, registers proxied tools
│ ├── connector.py # MCP client for a single upstream (stdio/SSE)
│ ├── registry.py # Server config dataclass + YAML loader
│ ├── defaults.py # Built-in default upstream configs
│ └── env_resolver.py # ${VAR} placeholder resolution
├── upstreams.yaml # User-editable upstream config
├── templates/ # Jinja2 dashboard
├── static/css/ # Dark-themed dashboard styles
├── Dockerfile # Multi-stage (Python + Node.js for npx)
├── docker-compose.yml # Local dev stack
└── .gitlab-ci.yml # CI/CD pipelineDevelopment
python -m venv .venv
source .venv/bin/activate
pip install -e .[dev]
# Run locally
export MH_DATABASE_URL=postgresql+asyncpg://mcphub:mcphub@localhost:5432/mcphub
uvicorn mcp_hub.main:app --reload --port 8500
# Lint & test
ruff check .
pytest -vThis server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-qualityCmaintenanceAggregates multiple MCP servers into a single gateway with unified top-level tools, reducing LLM context usage and enabling IDE compatibility by consolidating many tools into fewer interface functions.Last updated13
- Alicense-qualityCmaintenanceA universal gateway that aggregates multiple MCP servers into a single interface while providing advanced token optimization, result filtering, and automated summarization. It enables efficient management of large tool catalogs and reduces context usage by up to 95% for major AI clients.Last updated3515MIT
- Alicense-qualityCmaintenanceA unified gateway and web dashboard that aggregates multiple MCP servers into a single Streamable HTTP endpoint. It supports stdio, SSE, and HTTP protocols, featuring optimized tool exposure modes to reduce token consumption for AI clients.Last updated5MIT
- Flicense-qualityBmaintenanceAggregates multiple shared MCP servers into a single HTTP gateway, providing a unified, observable, and reusable MCP access layer for multiple AI clients like Codex, OpenCode, and OpenClaw. It centralizes configuration management, logging, health checks, and circuit breaking to simplify multi-client MCP deployments.Last updated5
Related MCP Connectors
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
One PAT, any MCP agent: Vercel, GitHub, Cloudflare, Supabase, GCP — unified dev infra gateway.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/LemonWasTakenAgain/mcp-hub'
If you have feedback or need assistance with the MCP directory API, please join our Discord server