Add resources and prompts to time server closes #404 (#709)

Signed-off-by: Mihai Criveti <[email protected]>

Author: crivetimihai

docs/docs/using/servers/go-fast-time-server.md

@@ -8,6 +8,8 @@ The **fast-time-server** is a high-performance Go-based MCP server that provides
 
 - **Multiple Transport Modes**: stdio, HTTP (JSON-RPC), SSE, dual (MCP + REST), and REST API
 - **Comprehensive Time Operations**: Get system time, convert between timezones
+- **MCP Resources**: Timezone data, world times, format examples, business hours
+- **MCP Prompts**: Time comparisons, meeting scheduling, detailed conversions
 - **REST API**: Traditional HTTP endpoints alongside MCP protocol
 - **OpenAPI Documentation**: Interactive Swagger UI and OpenAPI 3.0 specification
 - **CORS Support**: Enabled for browser-based testing
@@ -115,6 +117,146 @@ Converts time between different timezones.
 }
 ```
 
+## MCP Resources
+
+The server provides four MCP resources that can be accessed through the MCP protocol:
+
+### timezone://info
+Comprehensive timezone information including offsets, DST status, major cities, and population data.
+
+**Example Response:**
+```json
+{
+  "timezones": [
+    {
+      "id": "America/New_York",
+      "name": "Eastern Time",
+      "offset": "-05:00",
+      "dst": true,
+      "abbreviation": "EST/EDT",
+      "major_cities": ["New York", "Toronto", "Montreal"],
+      "population": 141000000
+    }
+  ],
+  "timezone_groups": {
+    "us_timezones": ["America/New_York", "America/Chicago", "America/Denver", "America/Los_Angeles"]
+  }
+}
+```
+
+### time://current/world
+Current time in major cities around the world, updated in real-time.
+
+**Example Response:**
+```json
+{
+  "last_updated": "2025-01-10T16:30:00Z",
+  "times": {
+    "New York": "2025-01-10 11:30:00 EST",
+    "London": "2025-01-10 16:30:00 GMT",
+    "Tokyo": "2025-01-11 01:30:00 JST"
+  }
+}
+```
+
+### time://formats
+Examples of supported time formats for parsing and display.
+
+**Example Response:**
+```json
+{
+  "input_formats": [
+    "2006-01-02 15:04:05",
+    "2006-01-02T15:04:05Z",
+    "2006-01-02T15:04:05-07:00"
+  ],
+  "output_formats": {
+    "iso8601": "2006-01-02T15:04:05Z07:00",
+    "rfc3339": "2006-01-02T15:04:05Z"
+  }
+}
+```
+
+### time://business-hours
+Standard business hours across different regions.
+
+**Example Response:**
+```json
+{
+  "regions": {
+    "north_america": {
+      "standard_hours": "9:00 AM - 5:00 PM",
+      "lunch_break": "12:00 PM - 1:00 PM",
+      "working_days": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"]
+    }
+  }
+}
+```
+
+## MCP Prompts
+
+The server provides three prompt templates for common time-related tasks:
+
+### compare_timezones
+Compare current times across multiple time zones.
+
+**Arguments:**
+- `timezones` (required): Comma-separated list of timezone IDs
+- `reference_time` (optional): Reference time (defaults to now)
+
+**Example:**
+```json
+{
+  "prompt": "compare_timezones",
+  "arguments": {
+    "timezones": "UTC,America/New_York,Asia/Tokyo"
+  }
+}
+```
+
+### schedule_meeting
+Find optimal meeting time across multiple time zones.
+
+**Arguments:**
+- `participants` (required): Comma-separated list of participant locations/timezones
+- `duration` (required): Meeting duration in minutes
+- `preferred_hours` (optional): Preferred time range (default: "9 AM - 5 PM")
+- `date_range` (optional): Date range to consider (default: "next 7 days")
+
+**Example:**
+```json
+{
+  "prompt": "schedule_meeting",
+  "arguments": {
+    "participants": "New York,London,Tokyo",
+    "duration": "60",
+    "preferred_hours": "9 AM - 5 PM"
+  }
+}
+```
+
+### convert_time_detailed
+Convert time with detailed context.
+
+**Arguments:**
+- `time` (required): Time to convert
+- `from_timezone` (required): Source timezone
+- `to_timezones` (required): Comma-separated list of target timezones
+- `include_context` (optional): Include contextual information (true/false)
+
+**Example:**
+```json
+{
+  "prompt": "convert_time_detailed",
+  "arguments": {
+    "time": "2025-01-10T10:00:00Z",
+    "from_timezone": "UTC",
+    "to_timezones": "America/New_York,Europe/London,Asia/Tokyo",
+    "include_context": "true"
+  }
+}
+```
+
 ## REST API Endpoints
 
 When using `rest` or `dual` transport modes, the following REST endpoints are available:
@@ -205,6 +347,35 @@ curl http://localhost:8080/api/v1/timezones/Asia/Tokyo/info
 }
 ```
 
+### MCP Resources via REST
+
+```bash
+# List all resources
+curl http://localhost:8080/api/v1/resources
+
+# Get specific resource
+curl http://localhost:8080/api/v1/resources/timezone-info
+curl http://localhost:8080/api/v1/resources/current-world
+curl http://localhost:8080/api/v1/resources/time-formats
+curl http://localhost:8080/api/v1/resources/business-hours
+```
+
+### MCP Prompts via REST
+
+```bash
+# List all prompts
+curl http://localhost:8080/api/v1/prompts
+
+# Execute a prompt
+curl -X POST http://localhost:8080/api/v1/prompts/compare_timezones/execute \
+  -H "Content-Type: application/json" \
+  -d '{"timezones": "UTC,America/New_York,Asia/Tokyo"}'
+
+curl -X POST http://localhost:8080/api/v1/prompts/schedule_meeting/execute \
+  -H "Content-Type: application/json" \
+  -d '{"participants": "New York,London,Tokyo", "duration": "60"}'
+```
+
 ### Test Endpoints
 ```bash
 # Echo test

mcp-servers/go/fast-time-server/Makefile

@@ -180,6 +180,35 @@ docker-run-sse-auth: docker-build
 	    -e AUTH_TOKEN=$(TOKEN) \
 	    $(IMAGE) -transport=sse -listen=0.0.0.0 -port=8080 -auth-token=$(TOKEN)
 
+# =============================================================================
+# 📚 MCP RESOURCES & PROMPTS TESTING
+# =============================================================================
+# help: 📚 MCP RESOURCES & PROMPTS
+# help: test-resources        - Test MCP resources via REST API
+# help: test-prompts          - Test MCP prompts via REST API
+# help: test-mcp              - Test all MCP features (resources + prompts)
+
+.PHONY: test-resources test-prompts test-mcp
+
+test-resources:
+	@echo "$(C_BLUE)➜ Testing MCP Resources...$(C_RESET)"
+	@curl -s http://localhost:8080/api/v1/resources | jq .
+	@echo "\n$(C_BLUE)➜ Timezone Info:$(C_RESET)"
+	@curl -s http://localhost:8080/api/v1/resources/timezone-info | jq '.timezones[0]'
+	@echo "\n$(C_BLUE)➜ Current World Times:$(C_RESET)"
+	@curl -s http://localhost:8080/api/v1/resources/current-world | jq .
+
+test-prompts:
+	@echo "$(C_BLUE)➜ Testing MCP Prompts...$(C_RESET)"
+	@curl -s http://localhost:8080/api/v1/prompts | jq .
+	@echo "\n$(C_BLUE)➜ Compare Timezones:$(C_RESET)"
+	@curl -s -X POST http://localhost:8080/api/v1/prompts/compare_timezones/execute \
+	     -H "Content-Type: application/json" \
+	     -d '{"timezones":"UTC,America/New_York,Asia/Tokyo"}' | jq .
+
+test-mcp: test-resources test-prompts
+	@echo "\n$(C_BLUE)✔ MCP Features Test Complete$(C_RESET)"
+
 # =============================================================================
 # 🚀 BENCHMARKING (hey)
 # =============================================================================

mcp-servers/go/fast-time-server/README.md

@@ -10,6 +10,9 @@
 
 ## Features
 
+- **MCP Tools**: `get_system_time` and `convert_time` for timezone operations
+- **MCP Resources**: Timezone information, world times, format examples, business hours
+- **MCP Prompts**: Time comparisons, meeting scheduling, detailed conversions
 - Five transports: `stdio`, `http` (JSON-RPC 2.0), `sse`, `dual` (MCP + REST), and `rest` (REST API only)
 - REST API with OpenAPI documentation for direct HTTP access
 - Single static binary (~2 MiB)
@@ -62,6 +65,49 @@ Also available as releases.
 | `-port`           | `8080`    | Port for HTTP/SSE/dual                  |
 | `-auth-token`     | *(empty)* | Bearer token for SSE authentication     |
 
+## MCP Features
+
+### Tools
+
+The server provides two main MCP tools:
+
+1. **get_system_time** - Returns the current time in any IANA timezone
+   - Parameter: `timezone` (optional, defaults to UTC)
+
+2. **convert_time** - Converts time between different timezones
+   - Parameters: `time`, `source_timezone`, `target_timezone` (all required)
+
+### Resources
+
+The server exposes four MCP resources:
+
+1. **timezone://info** - Comprehensive timezone information
+   - Includes offset, DST status, major cities, and population data
+
+2. **time://current/world** - Current time in major cities
+   - Real-time updates for global cities
+
+3. **time://formats** - Time format examples
+   - Input/output format specifications and examples
+
+4. **time://business-hours** - Business hours by region
+   - Working hours, lunch breaks, and holidays for different regions
+
+### Prompts
+
+Three prompt templates are available:
+
+1. **compare_timezones** - Compare times across multiple zones
+   - Arguments: `timezones` (required), `reference_time` (optional)
+
+2. **schedule_meeting** - Find optimal meeting times
+   - Arguments: `participants` (required), `duration` (required),
+     `preferred_hours` (optional), `date_range` (optional)
+
+3. **convert_time_detailed** - Convert with context
+   - Arguments: `time`, `from_timezone`, `to_timezones` (all required),
+     `include_context` (optional)
+
 ## API Reference
 
 ### REST API Endpoints
@@ -133,6 +179,35 @@ curl http://localhost:8080/api/v1/timezones/Asia/Tokyo/info
 
 Convert multiple times in a single request.
 
+#### MCP Resources
+**GET** `/api/v1/resources` - List all available MCP resources
+**GET** `/api/v1/resources/{uri}` - Get specific resource content
+
+Available resource URIs:
+- `timezone-info` - Comprehensive timezone information
+- `current-world` - Current world times
+- `time-formats` - Time format examples
+- `business-hours` - Business hours by region
+
+```bash
+curl http://localhost:8080/api/v1/resources/timezone-info
+```
+
+#### MCP Prompts
+**GET** `/api/v1/prompts` - List all available MCP prompts
+**POST** `/api/v1/prompts/{name}/execute` - Execute a prompt with arguments
+
+Available prompts:
+- `compare_timezones` - Compare times across zones
+- `schedule_meeting` - Find optimal meeting times
+- `convert_time_detailed` - Convert with context
+
+```bash
+curl -X POST http://localhost:8080/api/v1/prompts/compare_timezones/execute \
+  -H "Content-Type: application/json" \
+  -d '{"timezones":"UTC,America/New_York,Asia/Tokyo"}'
+```
+
 #### Test Endpoints
 - **GET** `/api/v1/test/echo` - Echo test endpoint
 - **POST** `/api/v1/test/validate` - Validate JSON input