본문으로 건너뛰기

get-current-time MCP Tool

개요​

get-current-time MCP Tool은 현재 날짜와 시간을 다양한 형식과 타임존으로 조회할 수 있는 도구입니다. 타임존 변환, 시간 동기화, 로그 타임스탬프 분석 등에 활용할 수 있습니다.

이 문서에서는 다음 사용 방법을 다룹니다:

  • JSON 형식: 구조화된 데이터로 정확한 제어가 필요한 경우
  • LLM AI Chat: 자연어로 간편하게 사용하고 싶은 경우

두 방법 모두 같은 결과를 제공하며, 사용자의 선호도와 상황에 따라 선택할 수 있습니다.

도구 정보​

  • 이름: get_current_time
  • 설명: 현재 날짜와 시간을 다양한 형식으로 조회
  • 카테고리: 시간 관리 도구

파라미터​

모든 파라미터는 선택사항이며, 기본값이 제공됩니다.

선택 파라미터​

파라미터타입기본값설명예시
timezonestring"UTC"시간 표시 타임존"Asia/Seoul"
formatstring"ISO"시간 형식"Korean"
includeWeekdaybooleanfalse요일 포함 여부true

지원 타임존​

  • UTC: 협정 세계시 (기본값)
  • Asia/Seoul / KST: 한국 표준시
  • America/New_York / EST: 미국 동부 표준시
  • Europe/London / GMT: 그리니치 표준시

지원 형식​

  • ISO: ISO 8601 형식 (기본값)
  • Korean: 한국어 형식
  • US: 미국 형식 (12시간제)
  • European: 유럽 형식 (24시간제)
  • Unix: Unix 타임스탬프

LLM AI Chat에서의 사용법​

LLM AI Chat에서는 자연어로 현재 시간을 조회할 수 있습니다.

기본 시간 조회​

현재 시간을 알려주세요.

또는

지금 몇 시인지 알려주세요.

특정 타임존 시간 조회​

한국 시간으로 현재 시간을 알려주세요.
미국 동부 시간으로 지금 시간을 확인해주세요.

특정 형식으로 조회​

현재 시간을 한국어 형식으로 알려주세요.
Unix 타임스탬프로 현재 시간을 확인해주세요.

요일 포함 조회​

오늘이 무슨 요일인지 함께 알려주세요.
한국 시간으로 현재 시간과 요일을 알려주세요.

자연어 응답 예시​

요청: "한국 시간으로 현재 시간과 요일을 알려주세요."

응답: "현재 시간 정보:

현재 시간: 2025년 1월 8일 수요일 19시 30분 45초 타임존: Asia/Seoul (KST) 형식: Korean 타임스탬프: 1736339445000 ISO 형식: 2025-01-08T10:30:45.000Z 요일:

  • 한국어: 수요일
  • 영어: Wednesday

메타데이터:

  • 도메인: time-management
  • 도구: get_current_time
  • 버전: 1.0.0
  • 실행 시각: 2025-01-08T10:30:45.123Z"

사용 예시 (JSON 형식)​

기본 시간 조회 (UTC)​

{
  "tool": "get_current_time",
  "arguments": {}
}

한국 시간 조회​

{
  "tool": "get_current_time",
  "arguments": {
    "timezone": "Asia/Seoul",
    "format": "Korean",
    "includeWeekday": true
  }
}

미국 형식 시간 조회​

{
  "tool": "get_current_time",
  "arguments": {
    "timezone": "America/New_York",
    "format": "US",
    "includeWeekday": true
  }
}

Unix 타임스탬프 조회​

{
  "tool": "get_current_time",
  "arguments": {
    "format": "Unix"
  }
}

응답 형식​

성공 응답 예시​

{
  "content": [
    {
      "type": "text",
      "text": "현재 시각 정보(bok)\n\n{\n  \"currentTime\": \"2025년 1월 8일 수요일 19시 30분 45초\",\n  \"timezone\": \"Asia/Seoul (KST)\",\n  \"format\": \"Korean\",\n  \"timestamp\": 1736339445000,\n  \"iso\": \"2025-01-08T10:30:45.000Z\",\n  \"weekday\": {\n    \"korean\": \"수요일\",\n    \"english\": \"Wednesday\"\n  },\n  \"metadata\": {\n    \"domain\": \"time-management\",\n    \"tool\": \"get_current_time\",\n    \"version\": \"1.0.0\",\n    \"executedAt\": \"2025-01-08T10:30:45.123Z\"\n  }\n}"
    }
  ]
}

응답 데이터 구조​

필드설명
currentTime요청한 형식의 시간 문자열
timezone적용된 타임존
format사용된 형식
timestampUnix 타임스탬프 (밀리초)
isoISO 8601 형식 시간
weekday요일 정보 (includeWeekday가 true인 경우)
metadata도구 실행 메타데이터

사용 시나리오​

시나리오 1: 로그 분석 시 시간 확인​

LLM AI Chat:

로그 분석을 위해 현재 UTC 시간을 ISO 형식으로 알려주세요.

JSON 형식:

{
  "tool": "get_current_time",
  "arguments": {
    "timezone": "UTC",
    "format": "ISO"
  }
}

시나리오 2: 다중 타임존 시간 확인​

LLM AI Chat:

한국, 미국, 유럽 시간을 모두 확인해주세요.

JSON 형식 (순차 실행):

// 한국 시간
{
  "tool": "get_current_time",
  "arguments": {
    "timezone": "Asia/Seoul",
    "format": "Korean",
    "includeWeekday": true
  }
}

// 미국 시간
{
  "tool": "get_current_time",
  "arguments": {
    "timezone": "America/New_York",
    "format": "US",
    "includeWeekday": true
  }
}

// 유럽 시간
{
  "tool": "get_current_time",
  "arguments": {
    "timezone": "Europe/London",
    "format": "European",
    "includeWeekday": true
  }
}

시나리오 3: 테스트 실행 시각 기록​

LLM AI Chat:

테스트 실행 시점을 기록하기 위해 현재 시간을 정확히 알려주세요.

JSON 형식:

{
  "tool": "get_current_time",
  "arguments": {
    "timezone": "UTC",
    "format": "ISO",
    "includeWeekday": false
  }
}

시나리오 4: 사용자 친화적 시간 표시​

LLM AI Chat:

사용자에게 보여줄 친숙한 형식으로 현재 시간을 알려주세요.

JSON 형식:

{
  "tool": "get_current_time",
  "arguments": {
    "timezone": "Asia/Seoul",
    "format": "Korean",
    "includeWeekday": true
  }
}

형식별 출력 예시​

ISO 형식 (기본값)​

2025-01-08T10:30:45.000Z

Korean 형식​

2025년 1월 8일 19시 30분 45초

US 형식​

January 8, 2025 at 7:30:45 PM

European 형식​

08/01/2025 19:30:45

Unix 형식​

1736339445

활용 사례​

1. 테스트 자동화​

// 테스트 시작 시각 기록
const startTime = await mcpTool.execute({
  tool: "get_current_time",
  arguments: { format: "ISO" }
});

// 테스트 실행...

// 테스트 종료 시각 기록
const endTime = await mcpTool.execute({
  tool: "get_current_time",
  arguments: { format: "ISO" }
});

2. 로그 분석​

// 현재 시간 기준으로 최근 1시간 로그 조회
const currentTime = await mcpTool.execute({
  tool: "get_current_time",
  arguments: { format: "ISO" }
});

const oneHourAgo = new Date(Date.now() - 3600000).toISOString();

const logs = await mcpTool.execute({
  tool: "query_logs",
  arguments: {
    startTime: oneHourAgo,
    endTime: currentTime.timestamp
  }
});

3. 시간 동기화 확인​

// 여러 타임존의 시간을 동시에 확인
const timezones = ["UTC", "Asia/Seoul", "America/New_York"];
const timeChecks = await Promise.all(
  timezones.map(tz => mcpTool.execute({
    tool: "get_current_time",
    arguments: { timezone: tz, format: "ISO" }
  }))
);

문제 해결​

일반적인 문제​

  1. 타임존 오류: 지원하지 않는 타임존 입력
  2. 형식 오류: 잘못된 형식 지정
  3. 시간 차이: 클라이언트와 서버 시간 차이

에러 응답 예시​

{
  "content": [
    {
      "type": "text",
      "text": "오류: 현재 시각을 가져오는 중 오류가 발생했습니다\n세부사항: Invalid timezone specified"
    }
  ],
  "isError": true
}

성능 고려사항​

  1. 빠른 응답: 로컬 시간 계산으로 빠른 응답 제공
  2. 타임존 처리: 주요 타임존만 지원하여 성능 최적화
  3. 캐싱: 시간 정보는 실시간으로 생성되어 캐싱 불필요

관련 도구​

  • change-user-day-index: 사용자 가상 시간 변경
  • get-user-virtual-time: 사용자 가상 시간 조회
  • get-user-timemachine-status: TimeMachine 상태 확인

관련 문서​