Time MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

IANA 시간대 이름(America/Los_Angeles, Europe/Berlin) — 일광 절약 시간을 올바르게 처리합니다
항상 실제 현재 시간을 반환합니다 — Claude만으로는 알 수 없습니다
두 가지 도구, 복잡함 없음
API 키 필요 없음, 호스트 시계 조회 외에 네트워크 호출 없음

라이브 데모

실제 사용 모습

time.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "time",
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "time": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-server-time"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add time -- uvx mcp-server-time

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Time

4개 시간대에서 작동하는 회의 시간 찾기

👤 분산된 팀으로 일정을 잡는 모든 사람 ⏱ ~3 min beginner

언제 쓸까: 누군가에게는 오전 6시가 아니고, 다른 누군가에게는 밤 10시가 아닌 30분 슬롯이 필요할 때입니다.

흐름

Claude를 실제 현재 시간에 고정합니다

What's the current time in America/Los_Angeles, America/New_York, Europe/London, and Asia/Tokyo?✓ 복사됨

→ 네 개의 정확한 시계 시간, 낡은 추측이 아닙니다
후보 슬롯 변환

Convert 10:00 America/Los_Angeles on the next Tuesday to the other 3 zones. Flag if it falls outside 8am-7pm local for anyone.✓ 복사됨

→ 근무 시간 외 표시가 있는 4행 표
2가지 인간적인 슬롯 제안

Suggest 2 weekly recurring slots that keep everyone inside 8am-6pm local. No slots that require someone to work a weekend.✓ 복사됨

→ 트레이드오프가 있는 두 가지 실행 가능한 옵션

결과: 변환 수학이 표시된 인간적인 회의 시간, 캘린더 초대장으로 보낼 준비가 된 상태입니다.

함정

DST 변환이 중간에 오프셋을 뒤집습니다 — 항상 IANA 시간대 이름(America/Los_Angeles)을 사용하세요. DST 변경 시 오래된 'UTC-8' 같은 오프셋은 사용하지 마세요
반시간 오프셋 시간대(인도, 네팔, 호주의 일부) — 도구를 신뢰하세요 — 도구가 처리합니다. Claude가 시간으로 반올림하도록 허용하지 마세요

로그 시간을 로컬 시간대로 변환하여 타임스탬프 버그 디버깅하기

👤 문제 해결 중 UTC 로그를 읽는 엔지니어 ⏱ ~5 min beginner

언제 쓸까: 로그는 UTC이고, 뇌는 태평양 시간대이며, 인시던트 연관성이 계속 잘못될 때입니다.

흐름

인시던트 창 번역

Convert 2026-04-14T22:37:00Z to America/Los_Angeles. Also give me the same moment in Europe/Amsterdam where our ops on-call was.✓ 복사됨

→ 나란히 표시된 두 개의 로컬 시간
DST 상태 확인

Was DST in effect in America/Los_Angeles at that instant? What was the UTC offset?✓ 복사됨

→ 오프셋 출력(예: -07:00), DST 확인됨
인간의 이벤트와 연관

Given the incident was 15:37 PT, does that line up with the Slack thread from 'Monday afternoon'?✓ 복사됨

→ 인간이 명명한 시간에 대한 건전성 확인

결과: 마침내 시간을 올바르게 파악했기 때문에 잘못된 배포에 대해 비난하는 것을 멈춥니다.

함정

'Z', '+00:00', 순진한 타임스탬프 혼합 — 항상 먼저 명시적 UTC로 변환하세요. 프롬프트에서 시간대 없는 타임스탬프는 거부하세요

함께 쓰기: sentry · postgres

조합

다른 MCP와 조합해 10배 효율

time + sentry

사후 분석 나레이션을 위해 인시던트 시작/종료 시간을 로컬 시간대로 번역합니다

For Sentry incident INC-42, convert the start and end timestamps into America/Los_Angeles and Europe/Berlin and write the postmortem timeline.✓ 복사됨

time + postgres

DB가 UTC를 저장할 때 올바른 로컬 날짜 경계로 쿼리합니다

How many signups happened on 2026-04-13 in America/Los_Angeles local time? Use the time tool to compute the UTC range, then query events.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
get_current_time	timezone: str (IANA 이름, 예: 'Europe/Berlin')	모든 날짜 추론 전에 모델을 실제 벽시계 시간에 고정하세요	무료
convert_time	source_timezone: str, time: str (HH:MM), target_timezone: str	특정 시계 시간을 두 시간대 간에 변환하세요	무료

비용 및 제한

운영 비용

API 쿼터: 없음 — 순수 로컬 계산
호출당 토큰: 극소 — 호출당 수백 개의 토큰
금액: 무료
팁: 예산 우려 없음. 날짜가 관련된 경우 자유롭게 호출하세요.

보안

권한, 시크릿, 파급범위

자격 증명 저장: 없음

데이터 외부 송신: 없음 — 호스트 시스템 시계 및 tzdata 읽음

정확성은 호스트 OS의 tzdata가 최신 상태에 따라 달라집니다 — 법규가 연중 DST 규칙을 변경할 때 드물지만 실제로 발생합니다.

문제 해결

자주 발생하는 오류와 해결

Unknown timezone: 'PST'

약자가 아닌 IANA 이름을 사용하세요. 'PST' → 'America/Los_Angeles'. 'EST' → 'America/New_York'. 약자는 모호합니다(IST = 인도 또는 아일랜드?).

Returned time seems an hour off

DST 변환 엣지 케이스입니다. is_dst 필드로 확인하세요 — 잘못되면 호스트의 tzdata가 낡은 것입니다. 시스템 시간대 데이터베이스를 업데이트하세요.

확인: zdump -v America/Los_Angeles | head

convert_time returns 'ambiguous time' during DST fall-back

시계 시간이 두 번 발생합니다(오전 1:30이 두 번 실행됨). 명확한 변환을 위해 시간뿐만 아니라 날짜 시간을 지정하세요.

대안

Time 다른 것과 비교

대안	언제 쓰나	단점/장점
Google Calendar와 같은 전용 캘린더 MCP	시간을 계산하는 것이 아니라 실제로 회의를 예약하려고 할 때	더 무겁고 OAuth가 필요합니다 — 하지만 초대장으로 루프를 닫습니다

Time