The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Mcphub
Self-hosted MCP gateway and control plane for connecting, controlling, and operating MCP servers.
Install
$
docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphubClaude Code
claude mcp add mcphub -- docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphubCursor / Claude Desktop (mcp.json)
{
"mcpServers": {
"mcphub": {
"command": "docker",
"args": [
"run",
"-p",
"3000:3000",
"-v",
"./data:/app/data",
"samanhappy/mcphub"
]
}
}
}Install command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →MCPHub
An open-source, self-hosted MCP gateway and control plane for connecting, controlling, and operating MCP servers.
MCPHub provides a unified control point between AI clients and MCP servers. Connect local and remote MCP servers once, organize and route their capabilities through stable endpoints, control access with authentication, scoped credentials, and per-user visibility, and operate everything with centralized logs, activity tracking, and health monitoring.
It works with MCP clients such as Claude Code, Cursor, Cherry Studio, OpenWebUI, and other MCP-compatible applications.
🌐 Website, Demo & Docs
- Website: mcphub.app
- Documentation: docs.mcphub.app
- Demo Environment: demo.mcphub.app
🚀 Features
Connect once, expose everywhere
- Smart Routing ⭐ - AI-powered tool discovery using vector semantic search (Learn more)
- Unified MCP Gateway - Expose all connected servers through stable MCP endpoints, including routes for groups and individual servers
- Server Aliases and Routing - Define aliases and route clients to all servers, specific groups, individual servers, or smart routing
- SSE / Streamable HTTP / stdio Support - Connect local and remote MCP servers over the supported transports
- Hot-Swappable Config - Add, remove, or update servers without downtime
Control access and credentials
- Per-user Credentials ⭐ - Bind personal keys to one shared server, with encrypted storage and isolated stdio runtimes (Learn more)
- Authentication and Access Control - Use OAuth 2.0, bearer keys, and server or group visibility controls to manage access
- OAuth 2.0 Support ⭐ - Both client and server modes for secure authentication (Learn more)
- Social Login - Seamless GitHub and Google login support with Better Auth integration (requires Database Mode)
- Server and Group Management - Organize servers into groups, manage visibility, and control Tool, Prompt, and Resource exposure
Operate with confidence
- Logs and Observability - Inspect tool-call activity, request status, latency, and server logs
- Health Checks - Monitor connection health and server status from one place
- Web Dashboard - Manage server configuration and runtime operations from a browser
- MCP Apps Proxy - Transparently forward interactive MCP Apps on single-server routes (Learn more)
- Tool Result Compression - Transparently reduce large text tool outputs before they reach clients
- Database Mode - Store configuration in PostgreSQL for production environments (Learn more)
- Docker-Ready - Deploy instantly with containerized setup
🔧 Quick Start
Prerequisites
- Docker (recommended) — the fastest way to run MCPHub; all commands below use it
- Node.js
>=20.0.0and pnpm10.12.4— only needed to run from source or develop locally (see Local Development)
Start with Docker
docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub
Similar plugs
Reverse engineer anything with agents, from app behavior down to native binaries.
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)