Time MCP Server

Instructions

Implementation Reference

• src/mcp_server_time/server.py:59-69 (handler)

  The main handler function for the 'get_current_time' tool. It takes a timezone_name, retrieves the ZoneInfo object, gets the current datetime in that timezone, and returns a TimeResult object containing the timezone, ISO-formatted datetime string, and DST status.

  def get_current_time(self, timezone_name: str) -> TimeResult:
      """Get current time in specified timezone"""
      timezone = get_zoneinfo(timezone_name)
      current_time = datetime.now(timezone)
  
      return TimeResult(
          timezone=timezone_name,
          datetime=current_time.isoformat(timespec="seconds"),
          is_dst=bool(current_time.dst()),
      )

• src/mcp_server_time/server.py:22-26 (schema)

  Pydantic model defining the structured output for the get_current_time tool response.

  class TimeResult(BaseModel):
      timezone: str
      datetime: str
      is_dst: bool

• src/mcp_server_time/server.py:127-140 (registration)

  Tool registration in the MCP server's list_tools pipeline, defining the tool's name, description, and input schema which requires a 'timezone' parameter as a string.

  Tool(
      name=TimeTools.GET_CURRENT_TIME.value,
      description="Get current time in a specific timezones",
      inputSchema={
          "type": "object",
          "properties": {
              "timezone": {
                  "type": "string",
                  "description": f"IANA timezone name (e.g., 'America/New_York', 'Europe/London'). Use '{local_tz}' as local timezone if no timezone provided by the user.",
              }
          },
          "required": ["timezone"],
      },
  ),

• src/mcp_server_time/server.py:51-56 (helper)

  Utility function to create a ZoneInfo object from a timezone name string, with error handling for invalid timezones. Called by the get_current_time handler.

  def get_zoneinfo(timezone_name: str) -> ZoneInfo:
      try:
          return ZoneInfo(timezone_name)
      except Exception as e:
          raise McpError(f"Invalid timezone: {str(e)}")

• src/mcp_server_time/server.py:17-19 (helper)

  String enum defining the canonical names for time-related tools, used in registration and dispatch.

  class TimeTools(str, Enum):
      GET_CURRENT_TIME = "get_current_time"
      CONVERT_TIME = "convert_time"