Time MCP Server

Instructions

Implementation Reference

• src/index.ts:171-173 (handler)

  The core handler function that computes the relative time from the given time string using dayjs's fromNow() method.

  function getRelativeTime(time: string) {
    return dayjs(time).fromNow();
  }

• src/index.ts:57-73 (handler)

  The switch case handler in CallToolRequestSchema that validates arguments, calls getRelativeTime, and returns the formatted response.

  case 'relative_time': {
    if (!checkRelativeTimeArgs(args)) {
      throw new Error(`Invalid arguments for tool: [${name}]`);
    }
  
    const time = args.time;
    const result = getRelativeTime(time);
    return {
      success: true,
      content: [
        {
          type: 'text',
          text: result,
        },
      ],
    };
  }

• src/tools.ts:35-48 (schema)

  Defines the tool metadata including name, description, and input schema for 'relative_time'.

  export const RELATIVE_TIME: Tool = {
    name: 'relative_time',
    description: 'Get the relative time from now.',
    inputSchema: {
      type: 'object',
      properties: {
        time: {
          type: 'string',
          description: 'The time to get the relative time from now. Format: YYYY-MM-DD HH:mm:ss',
        },
      },
      required: ['time'],
    },
  };

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

  Registers the relative_time tool by including RELATIVE_TIME in the tools list returned by ListToolsRequest handler.

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

• src/index.ts:213-220 (helper)

  Helper function to validate the input arguments for the relative_time tool.

  function checkRelativeTimeArgs(args: unknown): args is { time: string } {
    return (
      typeof args === 'object' &&
      args !== null &&
      'time' in args &&
      typeof args.time === 'string'
    );
  }