How prmalakoti/mcp-hub works
MCP Hub combines a NestJS control plane for registering and managing MCP server processes with a standalone STDIO MCP server that exposes health, time, calculator, and echo tools. The README describes a React frontend, but the sampled App.tsx is still the Vite starter, so no frontend-to-API behavior is inferred. The backend MCP client is also documented but not evidenced as an implemented runtime workflow in the sampled files; the graph focuses on verified management and tool-serving paths.
Main entry points: mcp.service.ts MCP Service · register-tools.ts Tool Registration · mcp.controller.ts MCP REST API · calculator.tool.ts Calculator Tool
Components 23
Frontend
- React App
client/src/App.tsx
Backend Control Plane
- MCP REST API
server/src/modules/mcp/mcp.controller.ts - MCP Service
server/src/modules/mcp/mcp.service.ts - Process Manager
server/src/modules/mcp/process/process-manager.service.ts - Server Records
server/src/modules/mcp/entities/mcp-server.entity.ts - Create DTO
server/src/modules/mcp/dto/create-mcp-server.dto.ts - Update DTO
server/src/modules/mcp/dto/update-mcp-server.dto.ts - Server Status
server/src/modules/mcp/enums/server-status.enum.ts - Database Config
server/src/config/database.config.ts
Standalone MCP Server
- MCP Runtime
server/mcp-server/main.ts - Tool Registration
server/mcp-server/register-tools.ts
MCP Tools
- Health Tool
server/mcp-server/tools/health/health.tool.ts - Health Logic
server/mcp-server/tools/health/health.service.ts - Time Tool
server/mcp-server/tools/time/time.tool.ts - Time Logic
server/mcp-server/tools/time/time.service.ts - Calculator Tool
server/mcp-server/tools/calculator/calculator.tool.ts - Calculator Schema
server/mcp-server/tools/calculator/calculator.schema.ts - Calculator Logic
server/mcp-server/tools/calculator/calculator.service.ts - Echo Tool
server/mcp-server/tools/echo/echo.tool.ts - Echo Schema
server/mcp-server/tools/echo/echo.schema.ts - Echo Logic
server/mcp-server/tools/echo/echo.service.ts
Other components
- User
- MCP Client
Connections 22
- User → React App: uses
- User → MCP REST API: manages servers
server/src/modules/mcp/mcp.controller.ts - React App → MCP REST API: calls API
- MCP REST API → MCP Service: delegates to
server/src/modules/mcp/mcp.controller.ts - MCP REST API → Create DTO: accepts
server/src/modules/mcp/mcp.controller.ts - MCP REST API → Update DTO: accepts
server/src/modules/mcp/mcp.controller.ts - MCP Service → Process Manager: starts and stops
server/src/modules/mcp/mcp.service.ts - MCP Service → Server Records: reads and writes
server/src/modules/mcp/mcp.service.ts - MCP Service → Server Status: sets status
server/src/modules/mcp/mcp.service.ts - MCP Service → Database Config: persists via ORM
- MCP Runtime → Tool Registration: registers tools
server/mcp-server/main.ts - Tool Registration → Health Tool: registers
server/mcp-server/register-tools.ts - Tool Registration → Time Tool: registers
server/mcp-server/register-tools.ts - Tool Registration → Calculator Tool: registers
server/mcp-server/register-tools.ts - Tool Registration → Echo Tool: registers
server/mcp-server/register-tools.ts - Health Tool → Health Logic: delegates to
server/mcp-server/tools/health/health.tool.ts - Time Tool → Time Logic: delegates to
server/mcp-server/tools/time/time.tool.ts - Calculator Tool → Calculator Logic: delegates to
server/mcp-server/tools/calculator/calculator.tool.ts - Calculator Tool → Calculator Schema: validates with
server/mcp-server/tools/calculator/calculator.tool.ts - Echo Tool → Echo Logic: delegates to
server/mcp-server/tools/echo/echo.tool.ts - Echo Tool → Echo Schema: validates with
server/mcp-server/tools/echo/echo.tool.ts - MCP Client → MCP Runtime: connects via STDIO
README.md