[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73931":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":16,"starSnapshotCount":16,"syncStatus":35,"lastSyncTime":36,"discoverSource":37},73931,"mcphub","samanhappy\u002Fmcphub","samanhappy","A unified hub for centrally managing and dynamically orchestrating multiple MCP servers\u002FAPIs into separate endpoints with flexible routing strategies.","https:\u002F\u002Fdocs.mcphub.app",null,"TypeScript",2149,261,17,34,0,14,33,76,42,103.35,"Apache License 2.0",false,"main",true,[27,28,29,30,31],"mcp","mcp-gateway","mcp-hub","mcp-router","mcp-server","2026-06-12 04:01:12","# MCPHub: The Unified Hub for Model Context Protocol (MCP) Servers\n\nEnglish | [Français](README.fr.md) | [中文版](README.zh.md)\n\nMCPHub makes it easy to manage and scale multiple MCP (Model Context Protocol) servers by organizing them into flexible Streamable HTTP (SSE) endpoints—supporting access to all servers, individual servers, or logical server groups.\n\n![Dashboard Preview](assets\u002Fdashboard.png)\n\n## 🌐 Live Demo & Docs\n\n- **Documentation**: [docs.mcphub.app](https:\u002F\u002Fdocs.mcphub.app\u002F)\n- **Demo Environment**: [demo.mcphub.app](https:\u002F\u002Fdemo.mcphub.app\u002F)\n\n## 🚀 Features\n\n- **Centralized Management** - Monitor and control all MCP servers from a unified dashboard\n- **Flexible Routing** - Access all servers, specific groups, or individual servers via HTTP\u002FSSE\n- **Granular Group Visibility** - Control Tool, Prompt, and Resource visibility independently for each server inside a group\n- **Smart Routing** - AI-powered tool discovery using vector semantic search ([Learn more](https:\u002F\u002Fdocs.mcphub.app\u002Ffeatures\u002Fsmart-routing))\n- **Hot-Swappable Config** - Add, remove, or update servers without downtime\n- **OAuth 2.0 Support** - Both client and server modes for secure authentication ([Learn more](https:\u002F\u002Fdocs.mcphub.app\u002Ffeatures\u002Foauth))\n- **Social Login** - Seamless GitHub and Google login support with Better Auth integration (requires Database Mode)\n- **Database Mode** - Store configuration in PostgreSQL for production environments ([Learn more](https:\u002F\u002Fdocs.mcphub.app\u002Fconfiguration\u002Fdatabase-configuration))\n- **Docker-Ready** - Deploy instantly with containerized setup\n\n## 🔧 Quick Start\n\n### Configuration\n\nCreate a `mcp_settings.json` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"time\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"time-mcp\"]\n    },\n    \"fetch\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-server-fetch\"]\n    }\n  }\n}\n```\n\n📖 See [Configuration Guide](https:\u002F\u002Fdocs.mcphub.app\u002Fconfiguration\u002Fmcp-settings) for full options including OAuth, environment variables, and more.\n\n### Docker Deployment\n\n```bash\n# Run with custom config (recommended)\ndocker run -p 3000:3000 -v .\u002Fmcp_settings.json:\u002Fapp\u002Fmcp_settings.json -v .\u002Fdata:\u002Fapp\u002Fdata samanhappy\u002Fmcphub\n\n# Or run with default settings\ndocker run -p 3000:3000 samanhappy\u002Fmcphub\n```\n\n### Access Dashboard\n\nOpen `http:\u002F\u002Flocalhost:3000` and log in with username `admin`. On first launch, if no `ADMIN_PASSWORD` environment variable is set, a random password is generated and printed to the server logs. You can also pre-set the password:\n\n```bash\n# Docker: set admin password via environment variable\ndocker run -p 3000:3000 -e ADMIN_PASSWORD=your-secure-password samanhappy\u002Fmcphub\n```\n\n> **Tip:** Change the admin password after first login for security.\n\n> **Headless mode:** Set `DISABLE_WEB=true` to skip serving the bundled dashboard UI and run MCPHub with only the backend\u002FAPI and MCP endpoints. This is useful when you want to manage servers directly from `mcp_settings.json`.\n\n### Connect AI Clients\n\nConnect AI clients (Claude Desktop, Cursor, etc.) via:\n\n```\nhttp:\u002F\u002Flocalhost:3000\u002Fmcp           # All servers\nhttp:\u002F\u002Flocalhost:3000\u002Fmcp\u002F{group}   # Specific group\nhttp:\u002F\u002Flocalhost:3000\u002Fmcp\u002F{server}  # Specific server\nhttp:\u002F\u002Flocalhost:3000\u002Fmcp\u002F$smart    # Smart routing\nhttp:\u002F\u002Flocalhost:3000\u002Fmcp\u002F$smart\u002F{group}  # Smart routing within group\n```\n\n> **Security note**: MCP endpoints require authentication by default to prevent accidental exposure. To allow unauthenticated MCP access, disable **Enable Bearer Authentication** in the Keys section. **Skip Authentication** only affects dashboard login. Use only in trusted environments.\n\n📖 See [API Reference](https:\u002F\u002Fdocs.mcphub.app\u002Fapi-reference) for detailed endpoint documentation.\n\n## 📚 Documentation\n\n| Topic                                                                          | Description                       |\n| ------------------------------------------------------------------------------ | --------------------------------- |\n| [Quick Start](https:\u002F\u002Fdocs.mcphub.app\u002Fquickstart)                             | Get started in 5 minutes          |\n| [Configuration](https:\u002F\u002Fdocs.mcphub.app\u002Fconfiguration\u002Fmcp-settings)           | MCP server configuration options  |\n| [Database Mode](https:\u002F\u002Fdocs.mcphub.app\u002Fconfiguration\u002Fdatabase-configuration) | PostgreSQL setup for production   |\n| [OAuth](https:\u002F\u002Fdocs.mcphub.app\u002Ffeatures\u002Foauth)                               | OAuth 2.0 client and server setup |\n| [Smart Routing](https:\u002F\u002Fdocs.mcphub.app\u002Ffeatures\u002Fsmart-routing)               | AI-powered tool discovery         |\n| [Docker Setup](https:\u002F\u002Fdocs.mcphub.app\u002Fconfiguration\u002Fdocker-setup)            | Docker deployment guide           |\n\n## 🧑‍💻 Local Development\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fsamanhappy\u002Fmcphub.git\ncd mcphub\npnpm install\npnpm dev\n```\n\n> For Windows users, start backend and frontend separately: `pnpm backend:dev`, `pnpm frontend:dev`\n\n📖 See [Development Guide](https:\u002F\u002Fdocs.mcphub.app\u002Fdevelopment) for detailed setup instructions.\n\n## 🔍 Tech Stack\n\n- **Backend**: Node.js, Express, TypeScript\n- **Frontend**: React, Vite, Tailwind CSS\n- **Auth**: JWT & bcrypt\n- **Protocol**: Model Context Protocol SDK\n\n## 👥 Contributing\n\nContributions welcome! See our [Discord community](https:\u002F\u002Fdiscord.gg\u002FqMKNsn5Q) for discussions and support.\n\n## ❤️ Sponsor\n\n[![ko-fi](https:\u002F\u002Fko-fi.com\u002Fimg\u002Fgithubbutton_sm.svg)](https:\u002F\u002Fko-fi.com\u002Fsamanhappy)\n\n## 🌟 Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=samanhappy\u002Fmcphub&type=Date)](https:\u002F\u002Fwww.star-history.com\u002F#samanhappy\u002Fmcphub&Date)\n\n## 📄 License\n\nLicensed under the [Apache 2.0 License](LICENSE).\n","MCPHub 是一个统一的管理平台，用于集中管理和动态编排多个MCP（Model Context Protocol）服务器\u002FAPI，并将其组织成具有灵活路由策略的独立端点。项目采用TypeScript开发，支持通过HTTP\u002FSSE访问所有服务器、特定组或单个服务器，提供细粒度的组可见性控制及智能路由功能，后者利用向量语义搜索技术进行工具发现。此外，MCPHub还具备热插拔配置、OAuth 2.0支持、社交登录选项、数据库模式存储以及Docker部署能力。该工具适用于需要高效管理和扩展多个MCP服务的应用场景，如AI模型托管服务、微服务架构下的API网关等。",2,"2026-06-11 03:47:58","high_star"]