Hi-AI

Instructions

Implementation Reference

• src/tools/time/getCurrentTime.ts:22-69 (handler)

  The main execution handler for the get_current_time tool. Handles different time formats (iso, local, utc, timestamp, human) and optional timezone, returning formatted time in MCP ToolResult format.

  export async function getCurrentTime(args: { format?: string; timezone?: string }): Promise<ToolResult> {
    const { format = 'iso', timezone } = args;
    const now = new Date();
    
    let timeResult: string;
    
    switch (format) {
      case 'iso':
        timeResult = now.toISOString();
        break;
      case 'local':
        timeResult = now.toLocaleString();
        break;
      case 'utc':
        timeResult = now.toUTCString();
        break;
      case 'timestamp':
        timeResult = Math.floor(now.getTime() / 1000).toString();
        break;
      case 'human':
        const options: Intl.DateTimeFormatOptions = {
          year: 'numeric',
          month: 'long',
          day: 'numeric',
          hour: '2-digit',
          minute: '2-digit',
          second: '2-digit',
          timeZone: timezone
        };
        timeResult = now.toLocaleString('en-US', options);
        break;
      default:
        timeResult = now.toISOString();
    }
    
    const currentTimeResult = {
      action: 'get_current_time',
      format,
      timezone: timezone || 'local',
      result: timeResult,
      timestamp: now.getTime(),
      status: 'success'
    };
    
    return {
      content: [{ type: 'text', text: `Time: ${timeResult}\nFormat: ${format}\nTimezone: ${timezone || 'local'}\nTimestamp: ${now.getTime()}` }]
    };
  }

• src/tools/time/getCurrentTime.ts:5-20 (schema)

  ToolDefinition object defining the schema, name, description, input parameters (format enum and optional timezone), and annotations for the get_current_time tool.

  export const getCurrentTimeDefinition: ToolDefinition = {
    name: 'get_current_time',
    description: 'what time|current time|time now|get time - Get current time',
    inputSchema: {
      type: 'object',
      properties: {
        format: { type: 'string', description: 'Time format', enum: ['iso', 'local', 'utc', 'timestamp', 'human'] },
        timezone: { type: 'string', description: 'Timezone (e.g., America/New_York, Asia/Seoul)' }
      },
      required: []
    },
    annotations: {
      title: 'Get Current Time',
      audience: ['user', 'assistant']
    }
  };

• src/index.ts:606-607 (registration)

  Tool handler registration in the central executeToolCall switch dispatcher, mapping 'get_current_time' calls to the getCurrentTime function.

  case 'get_current_time':
    return await getCurrentTime(args as any) as CallToolResult;

• src/index.ts:106-106 (registration)

  Registers the tool definition in the 'tools' array used for MCP listTools endpoint, enabling tool discovery.

  getCurrentTimeDefinition,

• src/index.ts:25-25 (registration)

  Imports the handler function and tool definition from the implementation file.

  import { getCurrentTime, getCurrentTimeDefinition } from './tools/time/getCurrentTime.js';