time-mcp

Instructions

Implementation Reference

• src/index.ts:175-177 (handler)

  Core handler function that computes the Unix timestamp (milliseconds) for the given time string parsed as UTC or the current time if no time provided.

  function getTimestamp(time?: string) {
    return time ? dayjs.utc(time).valueOf() : dayjs().valueOf();
  }

• src/index.ts:91-107 (handler)

  Tool dispatch handler in the CallToolRequestSchema that validates arguments, calls getTimestamp, and formats the response.

  case 'get_timestamp': {
    if (!checkTimestampArgs(args)) {
      throw new Error(`Invalid arguments for tool: [${name}]`);
    }
    const time = args.time;
    const result = getTimestamp(time);
    return {
      success: true,
      content: [
        {
          type: 'text',
          text: time 
            ? `The timestamp of ${time} (parsed as UTC) is ${result} ms.`
            : `The current timestamp is ${result} ms.`,
        },
      ],
    };

• src/tools.ts:64-76 (schema)

  Tool schema definition including name, description, and input schema for optional 'time' parameter.

  export const GET_TIMESTAMP: Tool = {
    name: 'get_timestamp',
    description: 'Get the timestamp for the time.',
    inputSchema: {
      type: 'object',
      properties: {
        time: {
          type: 'string',
          description: 'The time to get the timestamp. Format: YYYY-MM-DD HH:mm:ss.SSS',
        },
      },
    },
  };

• src/index.ts:30-34 (registration)

  Registers the get_timestamp tool (via GET_TIMESTAMP) in the list of available tools for ListToolsRequest.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return {
      tools: [CURRENT_TIME, RELATIVE_TIME, DAYS_IN_MONTH, GET_TIMESTAMP, CONVERT_TIME, GET_WEEK_YEAR],
    };
  });

• src/index.ts:231-239 (helper)

  Helper function to validate input arguments for the get_timestamp tool.

  function checkTimestampArgs(args: unknown): args is { time?: string } {
    if (args === undefined || args === null) {
      return true;
    }
    return (
      typeof args === 'object' &&
      (!('time' in (args as Record<string, unknown>)) || typeof (args as { time?: unknown }).time === 'string')
    );
  }