How kodekloudhub/mcp-for-beginners works
This repository is a teaching collection of MCP server examples, not one integrated application. An MCP client invokes each server’s tools and receives results from the relevant integration: Google Calendar, Ollama, Open-Meteo, or generated Postman API requests. The calendar example adds OAuth, tool registration, and multiple transports; the smaller examples show focused server-to-service patterns. Relationships for unsampled feature handlers and integrations follow the top-level README, so their internal call paths are not inferred.
Main entry points: server.ts Calendar server · core Calendar operations · tokenManager.ts Token manager · index.ts CLI entry
Components 25
Google Calendar MCP
- CLI entry
google-calendar-mcp/src/index.ts - Calendar server
google-calendar-mcp/src/server.ts - MCP transports
google-calendar-mcp/src/transports - Tool registry
google-calendar-mcp/src/tools/registry.ts - Calendar operations
google-calendar-mcp/src/handlers/core - Date conversion
google-calendar-mcp/src/handlers/utils/datetime.ts - OAuth flow
google-calendar-mcp/src/auth/server.ts - OAuth client
google-calendar-mcp/src/auth/client.ts - Token manager
google-calendar-mcp/src/auth/tokenManager.ts - Token files
google-calendar-mcp/src/auth/tokenManager.ts
Basic MCP Example
- Addition server
node-basic-mcp-server/server.js
Ollama MCP Examples
- Prompt tools
ollama-mcp/server.js - Demo server
ollamademo/server.js
Generated Postman Server
- MCP server
postman-mcp/postman-mcp-server/mcpServer.js - Tool discovery
postman-mcp/postman-mcp-server/lib/tools.js - Generated API tools
postman-mcp/postman-mcp-server/tools
Second Generated Server
- MCP server
postman-mcp/postman-mcp-server 2/mcpServer.js - Tool discovery
postman-mcp/postman-mcp-server 2/lib/tools.js - Generated API tools
postman-mcp/postman-mcp-server 2/tools
Weather MCP Example
- Weather tools
Weather-MCP-Server/server.js
Other components
- MCP client
- Google Calendar API
- Local Ollama
- External APIs
- Open-Meteo API
Connections 27
- MCP client → CLI entry: starts
- CLI entry → Calendar server: initializes
google-calendar-mcp/src/index.ts - Calendar server → MCP transports: connects
google-calendar-mcp/src/server.ts - Calendar server → Tool registry: registers tools
google-calendar-mcp/src/server.ts - Tool registry → Calendar operations: dispatches to
google-calendar-mcp/src/tools/registry.ts - Calendar server → OAuth client: initializes
google-calendar-mcp/src/server.ts - Calendar server → OAuth flow: starts auth
google-calendar-mcp/src/server.ts - Calendar server → Token manager: validates tokens
google-calendar-mcp/src/server.ts - OAuth flow → Token manager: manages tokens
google-calendar-mcp/src/auth/server.ts - Token manager → Token files: reads and writes
google-calendar-mcp/src/auth/tokenManager.ts - Calendar operations → Google Calendar API: calendar operations
- Calendar operations → Date conversion: converts dates
google-calendar-mcp/src/handlers/core/ListEventsHandler.ts - MCP client → Addition server: calls tool
- MCP client → Prompt tools: calls tools
- Prompt tools → Local Ollama: requests completions
- MCP client → Demo server: calls tools
- Demo server → Local Ollama: requests completions
- MCP client → MCP server: calls tools
- MCP server → Tool discovery: loads tools
postman-mcp/postman-mcp-server/mcpServer.js - Tool discovery → Generated API tools: imports tools
postman-mcp/postman-mcp-server/lib/tools.js - Generated API tools → External APIs: calls APIs
- MCP client → MCP server: calls tools
- MCP server → Tool discovery: loads tools
postman-mcp/postman-mcp-server 2/mcpServer.js - Tool discovery → Generated API tools: imports tools
postman-mcp/postman-mcp-server 2/lib/tools.js - Generated API tools → External APIs: calls APIs
- MCP client → Weather tools: requests weather
- Weather tools → Open-Meteo API: fetches forecasts