mcphub: Connect and Manage MCP Servers Through One Gateway
Summary
MCPHub is a self-hosted gateway and control plane for connecting MCP clients to local and remote MCP servers. It centralizes routing, access controls, credentials, logs, and health monitoring.
At a glance
- Language
- TypeScript
- License
- Apache-2.0
- Stars
- 2.5k
- Forks
- 330
- Added to OSRepos
- October 21, 2025
- Last analyzed
- October 3, 2026
Topics
Click on any tag to explore related repositories
Use at your own risk
OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.
Overview
MCPHub sits between MCP-compatible clients and MCP servers, giving operators one place to connect servers and expose their tools through stable endpoints. Rather than configuring each client against individual servers, teams can manage routing and access centrally.
It is suited to people running several MCP servers who want a self-hosted dashboard, shared controls, and operational visibility. It supports both local and remote connections and offers file-based configuration by default, with PostgreSQL available for database mode.
Key Features
- Routes clients to all connected servers, a group, an individual server, or smart routing endpoints.
- Connects to local and remote servers over stdio, SSE, and Streamable HTTP.
- Manages authentication, bearer keys, OAuth 2.0, and server or group visibility.
- Supports per-user credentials with encrypted storage and isolated stdio runtimes.
- Provides a web dashboard, activity logs, server logs, and health checks.
- Allows server configuration changes without downtime through hot-swappable configuration.
- Offers PostgreSQL-backed storage and vector-based smart routing as optional capabilities.
Use Cases
- A developer running several MCP servers can give Claude Code, Cursor, or another compatible client a single gateway endpoint.
- A team can group servers by project or purpose and control which users can access each group.
- An operator can centralize request logs and health checks when troubleshooting a self-hosted MCP setup.
- A deployment that needs individual users' credentials for a shared server can use per-user credential bindings.
Project Facts
- Language: TypeScript
- License: Apache-2.0
- Stars: 2.5k
- Forks: 330
- Topics: mcp, mcp-gateway, mcp-hub, mcp-router, mcp-server
- Archived: No
Getting Started
Run the Docker image with a persistent data directory:
docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub
Open http://localhost:3000 to access the dashboard. See the README and documentation for setup, configuration, and client connection details.
Alternatives
- mcp-gateway: A Rust gateway that also exposes REST APIs and uses on-demand tool discovery, while MCPHub focuses on managing MCP server connections and access.
- magictunnel: A Rust MCP proxy centered on natural-language tool discovery and invocation, rather than MCPHub’s centralized routing, access controls, and operations.
Considerations
- Docker is the recommended quick-start option. Running from source requires Node.js 20 or newer and pnpm 10.12.4.
- MCP endpoints require authentication by default. Disabling it should be limited to trusted environments.
- The default file-based configuration suits straightforward deployments; PostgreSQL is available for database mode.
- Smart routing relies on vector semantic search and is listed with PostgreSQL and pgvector in the project stack.
- The repository is active and licensed under Apache-2.0. Review the project's configuration and security guidance before exposing a gateway outside a trusted network.
Source repository
Open the original repository on GitHub.
17 counted GitHub visits
Related repositories
Similar repositories that may be relevant next.
OrcaReplay: Time Travel for AI Agents, Debugging and Evaluation
October 2, 2026
OrcaReplay introduces "time travel" capabilities for AI agents, allowing developers to record, replay, fork, and debug any agent run with any model. It addresses the challenges of AI agent debugging by providing byte-for-byte reproducibility, offline analysis, and the ability to compare different models from specific checkpoints. This tool, built by the OrcaRouter.ai team, enhances observability and control over complex agent behaviors.
OpenMake LLM: Self-Hosted AI Workspace for Local and Open-Weight LLMs
October 1, 2026
OpenMake LLM is an open-source, self-hosted AI workspace for local and open-weight LLMs. It coordinates specialized models, autonomous agents, and tools for deep research and artifact generation. This platform supports vLLM, LiteLLM, and BYOK providers, offering a robust environment for managing AI workloads.
ZenNotes: Keyboard-First Markdown Notes with Vim, Diagrams, and MCP Integration
October 1, 2026
ZenNotes is a versatile, keyboard-first Markdown notes app designed for speed and flexibility. It stores notes as plain Markdown files, offering Vim-friendly editing, diagram support, and integration with MCP tools. Available as a desktop app (Electron) and a self-hosted web app, ZenNotes provides a powerful solution for organizing your thoughts.
lat.md: A Knowledge Graph for Your Codebase, Written in Markdown
September 26, 2026
lat.md is an innovative tool that transforms your codebase knowledge into an interconnected graph of markdown files. It helps both AI agents and human developers quickly understand project architecture, business logic, and design decisions. By integrating directly into your project, lat.md ensures documentation remains consistent and up-to-date.