MCP Simple Timeserver

Instructions

Implementation Reference

• mcp_simple_timeserver/server.py:34-49 (handler)

  The core handler function for the 'get_utc' MCP tool. It queries the specified NTP server using ntplib, computes the UTC time, formats it, and returns it as a string. Handles NTP exceptions gracefully.

  def get_utc(server: str = DEFAULT_NTP_SERVER) -> str:
      """
      Returns accurate UTC time from an NTP server.
      This provides a universal time reference regardless of local timezone.
      
      :param server: NTP server address (default: pool.ntp.org)
      """
      try:
          ntp_client = ntplib.NTPClient()
          response = ntp_client.request(server, version=3)
          utc_time = datetime.fromtimestamp(response.tx_time, tz=UTC)
          formatted_time = utc_time.strftime("%Y-%m-%d %H:%M:%S")
          return f"Current UTC Time from {server}: {formatted_time}"
      except ntplib.NTPException as e:
          return f"Error getting NTP time: {str(e)}"

• mcp_simple_timeserver/server.py:28-33 (registration)

  FastMCP registration of the 'get_utc' tool using the @app.tool decorator, including metadata annotations for title and read-only hint.

  @app.tool(
      annotations = {
          "title": "Get UTC Time from an NTP Server",
          "readOnlyHint": True
      }
  )

• mcp_simple_timeserver/web/server.py:38-52 (handler)

  Identical handler function for the 'get_utc' tool in the web-enabled server variant.

  def get_utc(server: str = DEFAULT_NTP_SERVER) -> str:
      """
      Returns accurate UTC time from an NTP server.
      This provides a universal time reference regardless of local timezone.
      
      :param server: NTP server address (default: pool.ntp.org)
      """
      try:
          ntp_client = ntplib.NTPClient()
          response = ntp_client.request(server, version=3)
          utc_time = datetime.fromtimestamp(response.tx_time, tz=UTC)
          formatted_time = utc_time.strftime("%Y-%m-%d %H:%M:%S")
          return f"Current UTC Time from {server}: {formatted_time}"
      except ntplib.NTPException as e:
          return f"Error getting NTP time: {str(e)}" 

• mcp_simple_timeserver/web/server.py:32-37 (registration)

  FastMCP registration of the 'get_utc' tool in the web server variant.

  @app.tool(
      annotations = {
          "title": "Get UTC Time from an NTP Server",
          "readOnlyHint": True
      }
  )

• dxt/prepare-DXT.py:172-174 (schema)

  Tool schema definition in the DXT manifest generator for packaging the MCP server.

      "name": "get_utc",
      "description": "Returns accurate UTC time from an NTP server."
  }