Update app.py

app.py

@@ -1,21 +1,110 @@
 # app.py
-import gradio as gr
+import json
+import logging
+import time
+import uuid
 from datetime import datetime, timezone
+import gradio as gr
+
+# ---------- Logging (JSON, UTC) ----------
+class JsonFormatter(logging.Formatter):
+    # Ensure all timestamps are UTC and RFC3339-like
+    converter = time.gmtime
+
+    def format(self, record: logging.LogRecord) -> str:
+        base = {
+            "ts": self.formatTime(record, "%Y-%m-%dT%H:%M:%S.%fZ"),
+            "level": record.levelname,
+            "logger": record.name,
+            "message": record.getMessage(),
+        }
+        # Include extras if provided
+        for k in ("request_id", "duration_ms", "event", "path", "client"):
+            if hasattr(record, k):
+                base[k] = getattr(record, k)
+        return json.dumps(base, ensure_ascii=False)
+
+def _setup_logging():
+    handler = logging.StreamHandler()
+    handler.setFormatter(JsonFormatter())
+    root = logging.getLogger()
+    root.handlers.clear()
+    root.addHandler(handler)
+    root.setLevel(logging.INFO)
+
+_setup_logging()
+log = logging.getLogger("datetime_mcp")
+
+# ---------- Time payload builder ----------
+def build_time_payload(dt: datetime) -> dict:
+    """
+    Return a compact, LLM-friendly bundle with multiple canonical formats
+    and useful calendar context. Always UTC.
+    """
+    # Basic forms
+    iso_utc = dt.replace(tzinfo=timezone.utc).isoformat().replace("+00:00", "Z")
+    unix_ms = int(dt.timestamp() * 1000)
+    unix_s = unix_ms // 1000
 
+    # Calendar context
+    iso_week_year, iso_week, iso_weekday = dt.isocalendar()
+    day_of_year = int(dt.strftime("%j"))
+
+    payload = {
+        # Canonical machine-readable
+        "iso_utc": iso_utc,            # RFC3339/ISO-8601 with Z
+        "unix_s": unix_s,              # seconds since epoch
+        "unix_ms": unix_ms,            # milliseconds since epoch
+
+        # Human-readable disambiguated strings (still UTC)
+        "date_utc": dt.strftime("%Y-%m-%d"),
+        "time_utc": dt.strftime("%H:%M:%S"),
+        "weekday_utc": dt.strftime("%A"),
+
+        # Calendar context (helps reasoning about “week/day”)
+        "iso_week": f"{iso_week_year}-W{iso_week:02d}",
+        "iso_weekday": iso_weekday,    # 1=Mon .. 7=Sun
+        "day_of_year": day_of_year,
+        "quarter": (dt.month - 1) // 3 + 1,
+
+        # Explicit timezone grounding
+        "timezone": "UTC",
+        "offset": "+00:00",
+
+        # Friendly summary (for quick reading / prompts)
+        "summary": dt.strftime("%A, %d %B %Y %H:%M:%S UTC"),
+    }
+    return payload
+
+# ---------- Tool function ----------
 def now_utc():
     """
-    Return the current time in ISO 8601 (UTC).
-    No inputs. Useful as a 'time' tool for MCP clients.
+    Return the current time bundle in JSON (UTC).
+    Generator -> streamable over HTTP/SSE.
     """
-    # generator -> streamable over HTTP/SSE (client will see a streamed event)
-    yield datetime.now(timezone.utc).isoformat()
+    req_id = str(uuid.uuid4())
+    t0 = time.perf_counter()
+
+    log.info("request_start", extra={"request_id": req_id, "event": "now_utc_start"})
+    dt = datetime.now(timezone.utc)
+    payload = build_time_payload(dt)
+
+    # Stream one JSON event (LLM-friendly)
+    yield json.dumps(payload, ensure_ascii=False)
+
+    dur_ms = int((time.perf_counter() - t0) * 1000)
+    log.info(
+        "request_end",
+        extra={"request_id": req_id, "event": "now_utc_end", "duration_ms": dur_ms},
+    )
 
+# ---------- Gradio app ----------
 demo = gr.Interface(
     fn=now_utc,
     inputs=None,
-    outputs=gr.Textbox(label="UTC datetime (ISO 8601)"),
+    outputs=gr.JSON(label="UTC time bundle (LLM-friendly)"),
     title="Datetime MCP Server",
-    description="Returns the current UTC datetime."
+    description="Returns the current UTC datetime as a structured JSON bundle for LLMs.",
 )
 
 if __name__ == "__main__":