MCP Node Time

Instructions

Implementation Reference

• src/index.ts:110-129 (handler)

  Handler for 'get_current_time' tool in the switch statement of CallToolRequestSchema, parses params, calls TimeService, formats and returns MCP response.

  case 'get_current_time': {
    const { timezone, format = 'iso' } = (args as unknown) as GetCurrentTimeParams;
    const result = TimeService.getCurrentTime(timezone, format);
    
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify({
            timezone: result.timezone,
            datetime: result.datetime,
            isDST: result.isDST,
            utcOffset: result.utcOffset,
            localizedFormat: result.localizedFormat,
            format: format,
          }, null, 2),
        },
      ],
    };
  }

• src/index.ts:27-45 (registration)

  Registration of 'get_current_time' tool in the tools array provided to ListToolsRequestSchema.

    name: 'get_current_time',
    description: 'Get the current date and time in a specific timezone with various formatting options',
    inputSchema: {
      type: 'object',
      properties: {
        timezone: {
          type: 'string',
          description: 'IANA timezone identifier (e.g., "America/New_York", "Europe/London", "Asia/Tokyo")',
        },
        format: {
          type: 'string',
          enum: ['iso', 'local', 'full'],
          description: 'Output format: "iso" for ISO 8601, "local" for MM/DD/YYYY HH:MM:SS, "full" for human-readable',
          default: 'iso',
        },
      },
      required: ['timezone'],
    },
  },

• src/interfaces.ts:15-18 (schema)

  TypeScript interface defining input parameters for get_current_time tool.

  export interface GetCurrentTimeParams {
    timezone: string;
    format?: 'iso' | 'local' | 'full';
  }

• src/time-service.ts:29-81 (helper)

  Core implementation of getCurrentTime logic in TimeService class, handles timezone validation, DST, offset, and formatting.

  static getCurrentTime(timezone: string, format: 'iso' | 'local' | 'full' = 'iso'): TimezoneInfo {
    this.validateTimezone(timezone);
  
    const now = new Date();
    
    const isDST = this.isDaylightSavingTime(now, timezone);
    const utcOffset = this.getUTCOffset(now, timezone);
  
    let datetime: string;
    let localizedFormat: string;
  
    switch (format) {
      case 'iso':
        datetime = new Date(now.toLocaleString('en-US', { timeZone: timezone })).toISOString();
        localizedFormat = datetime;
        break;
      case 'local':
        datetime = now.toLocaleString('en-US', { 
          timeZone: timezone,
          year: 'numeric',
          month: '2-digit',
          day: '2-digit',
          hour: '2-digit',
          minute: '2-digit',
          second: '2-digit',
          hour12: false
        });
        localizedFormat = datetime;
        break;
      case 'full':
        datetime = now.toLocaleString('en-US', { timeZone: timezone });
        localizedFormat = now.toLocaleString('en-US', { 
          timeZone: timezone,
          weekday: 'long',
          year: 'numeric',
          month: 'long',
          day: 'numeric',
          hour: '2-digit',
          minute: '2-digit',
          second: '2-digit',
          timeZoneName: 'long'
        });
        break;
    }
  
    return {
      timezone,
      datetime,
      isDST,
      utcOffset,
      localizedFormat
    };
  }