time — Claude Code MCP 서버

현재 시각 조회와 타임존 간 시간 변환을 제공하는 공식 reference MCP 서버. get_current_time(타임존별 현재시각)과 convert_time(타임존 간 변환) 두 도구를 제공한다.

time은 Model Context Protocol(MCP) 공식 reference 서버 중 하나로, AI 어시스턴트에 "현재 시각"과 "타임존 변환" 능력을 더하는 경량 유틸리티 서버다. LLM은 기본적으로 실제 현재 시각을 알지 못하고 학습 시점에 멈춰 있기 때문에, "지금 몇 시야?", "서울 기준 오후 3시는 뉴욕에선 몇 시야?" 같은 질문에 부정확하게 답하거나 추측하는 문제가 있다. time 서버는 이 공백을 메워, Claude Code가 호스트 시스템과 표준 타임존 데이터베이스를 근거로 정확한 시간을 다루게 해준다.

제공하는 도구는 두 가지다. get_current_time은 지정한 IANA 타임존(예: Asia/Seoul, America/New_York)의 현재 시각을 반환한다. convert_time은 한 타임존의 특정 시각을 다른 타임존 기준 시각으로 변환해, 일광절약시간(DST)까지 반영한 결과를 돌려준다. 두 도구 모두 외부 네트워크 호출 없이 시스템 시계와 타임존 규칙만으로 동작하는 단순·결정적 기능이다.

이 서버가 유용한 사람은, 회의·마감·릴리스 일정을 여러 지역 기준으로 따져야 하는 글로벌 협업 환경의 개발자, "오늘 날짜"나 "현재 시각"을 코드/문서/커밋 로그에 넣어야 하는 작업, 또는 시간대가 얽힌 스케줄링 로직을 다루는 사람이다. Python 기반이며 uvx로 간편하게 실행되어 설치 부담이 작다. 기능 범위가 좁고 명확해, 처음 MCP를 도입할 때 동작을 검증해 보는 입문용으로도 적합하다. 정확한 설치/실행 방식은 별도 표시된 명령과 공식 GitHub 문서를 확인하길 권장한다.

언제 쓰나

LLM이 모르는 "실제 현재 시각"이 필요할 때, 여러 지역의 회의·마감·배포 일정을 타임존 변환해 맞춰야 할 때, 커밋/문서/로그에 정확한 날짜·시간을 넣어야 할 때 쓰면 좋다. 일광절약시간까지 반영한 시각 변환이 필요한 글로벌 협업에 특히 유용하며, 기능이 단순·결정적이라 MCP 도입 검증용 입문 서버로도 적합하다.

설치

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

Python 기반이며 uvx(uv 패키지 러너)로 실행되므로, 시스템에 uv가 설치돼 있어야 한다(없으면 먼저 uv 설치 필요). 동작은 호스트 시스템 시계와 IANA 타임존 데이터에 의존하므로, 서버 시간이 틀어져 있으면 결과도 틀어진다 — 호스트 시각이 정확한지 먼저 확인하자. 타임존은 Asia/Seoul처럼 IANA 식별자를 사용한다. 기본 타임존 등 옵션은 공식 GitHub 문서 확인을 권장한다.

보안 주의

API 키·토큰 등 비밀키가 필요 없고(env 없음), 외부 네트워크나 결제·삭제 같은 부수효과가 없는 읽기성 유틸리티라 위험도가 낮다. 다만 호스트의 로컬 시각·타임존 설정에 접근하므로, 시스템 시계가 부정확하거나 조작되면 잘못된 시간이 그대로 응답에 반영될 수 있다. 또한 변환 결과 텍스트를 후속 자동화(일정 생성·삭제 등)에 그대로 넘길 경우, 외부 입력이 섞인 프롬프트 인젝션으로 의도치 않은 동작이 유도될 수 있으니 결과는 사람이 한 번 확인하는 게 안전하다.

자주 묻는 질문

time MCP 서버는 어떤 도구를 제공하나요?

두 가지입니다. get_current_time은 지정한 타임존의 현재 시각을 반환하고, convert_time은 한 타임존의 특정 시각을 다른 타임존 기준으로 변환합니다. 둘 다 일광절약시간(DST) 규칙을 반영합니다.

API 키나 별도 계정이 필요한가요?

아니요. 비밀키나 외부 계정이 필요 없습니다. 호스트 시스템 시계와 IANA 타임존 데이터만으로 동작하는 읽기성 유틸리티 서버라 외부 네트워크 호출도 없습니다.

왜 LLM에 별도 시간 서버가 필요한가요?

LLM은 학습 시점에 멈춰 있어 실제 현재 시각을 알지 못합니다. time 서버를 붙이면 Claude Code가 시스템 시계를 근거로 정확한 현재 시각과 타임존 변환 결과를 제공할 수 있습니다.