Time MCP 서버
Time
Time MCP 서버는 시간 및 시간대 변환 기능을 제공하는 Model Context Protocol 서버입니다. 이 서버는 LLM이 현재 시간 정보를 얻고 자동 시스템 시간대 감지를 통해 IANA 시간대 이름을 사용하여 시간대 변환을 수행할 수 있게 해줍니다.
특징
- 현재 시간 조회 기능
- 시간대 간 시간 변환 기능
- IANA 시간대 이름 사용
- 자동 시스템 시간대 감지
- 사용자 정의 시스템 시간대 설정 가능
API
도구
get_current_time
특정 시간대 또는 시스템 시간대의 현재 시간을 가져옵니다.
- 필수 인수:
-
timezone(문자열): IANA 시간대 이름(예: 'America/New_York', 'Europe/London') -
반환:
{ "timezone": "Europe/Warsaw", "datetime": "2024-01-01T13:00:00+01:00", "is_dst": false }
convert_time
시간대 간 시간을 변환합니다.
- 필수 인수:
source_timezone(문자열): 소스 IANA 시간대 이름time(문자열): 24시간 형식의 시간(HH:MM)-
target_timezone(문자열): 대상 IANA 시간대 이름 -
반환:
{ "source": { "timezone": "America/New_York", "datetime": "2024-01-01T12:30:00-05:00", "is_dst": false }, "target": { "timezone": "Asia/Tokyo", "datetime": "2024-01-01T12:30:00+09:00", "is_dst": false }, "time_difference": "+13.0h" }
사용 방법
설치
uv 사용(권장)
uv를 사용할 때는 특별한 설치가 필요하지 않습니다. uvx를 사용하여 mcp-server-time을 직접 실행합니다.
PIP 사용
또는 pip를 통해 mcp-server-time을 설치할 수 있습니다:
pip install mcp-server-time설치 후 스크립트로 실행할 수 있습니다:
python -m mcp_server_time구성
Claude.app에서 구성
Claude 설정에 다음을 추가하세요:
uvx 사용
{
"mcpServers": {
"time": {
"command": "uvx",
"args": ["mcp-server-time"]
}
}
}Docker 사용
{
"mcpServers": {
"time": {
"command": "docker",
"args": ["run", "-i", "--rm", "mcp/time"]
}
}
}pip 설치 사용
{
"mcpServers": {
"time": {
"command": "python",
"args": ["-m", "mcp_server_time"]
}
}
}Zed에서 구성
Zed settings.json에 추가하세요:
uvx 사용
"context_servers": [
"mcp-server-time": {
"command": {
"path": "uvx",
"args": ["mcp-server-time"]
}
}
],pip 설치 사용
"context_servers": {
"mcp-server-time": {
"command": {
"path": "python",
"args": ["-m", "mcp_server_time"]
}
}
},VS Code에서 구성
VS Code User Settings(JSON) 파일에 다음 JSON 블록을 추가하세요. Ctrl + Shift + P를 누르고 Preferences: Open User Settings (JSON)를 입력하여 이 작업을 수행할 수 있습니다.
선택적으로 작업 공간의 .vscode/mcp.json 파일에 추가할 수 있습니다. 이렇게 하면 다른 사람과 구성을 공유할 수 있습니다.
.vscode/mcp.json 파일을 사용할 때는 mcp 키가 필요합니다.
uvx 사용
{
"mcp": {
"servers": {
"time": {
"command": "uvx",
"args": ["mcp-server-time"]
}
}
}
}Docker 사용
{
"mcp": {
"servers": {
"time": {
"command": "docker",
"args": ["run", "-i", "--rm", "mcp/time"]
}
}
}
}사용자 정의 - 시스템 시간대
기본적으로 서버는 시스템의 시간대를 자동으로 감지합니다. 구성의 args 목록에 --local-timezone 인수를 추가하여 이를 재정의할 수 있습니다.
예시:
{
"command": "python",
"args": ["-m", "mcp_server_time", "--local-timezone=America/New_York"]
}상호 작용 예시
현재 시간 가져오기:
{
"name": "get_current_time",
"arguments": {
"timezone": "Europe/Warsaw"
}
}응답:
{
"timezone": "Europe/Warsaw",
"datetime": "2024-01-01T13:00:00+01:00",
"is_dst": false
}시간대 간 시간 변환:
{
"name": "convert_time",
"arguments": {
"source_timezone": "America/New_York",
"time": "16:30",
"target_timezone": "Asia/Tokyo"
}
}응답:
{
"source": {
"timezone": "America/New_York",
"datetime": "2024-01-01T12:30:00-05:00",
"is_dst": false
},
"target": {
"timezone": "Asia/Tokyo",
"datetime": "2024-01-01T12:30:00+09:00",
"is_dst": false
},
"time_difference": "+13.0h"
}디버깅
MCP 인스펙터를 사용하여 서버를 디버깅할 수 있습니다. uvx 설치의 경우:
npx @modelcontextprotocol/inspector uvx mcp-server-time또는 특정 디렉토리에 패키지를 설치했거나 개발 중인 경우:
cd path/to/servers/src/time
npx @modelcontextprotocol/inspector uv run mcp-server-timeClaude에 대한 질문 예시
- "지금 몇 시인가요?" (시스템 시간대 사용)
- "도쿄는 지금 몇 시인가요?"
- "뉴욕이 오후 4시일 때 런던은 몇 시인가요?"
- "도쿄 시간으로 오전 9시 30분을 뉴욕 시간으로 변환해주세요"
빌드
Docker 빌드:
cd src/time
docker build -t mcp/time .기여
mcp-server-time을 확장하고 개선하는 데 도움이 되는 기여를 권장합니다. 새로운 시간 관련 도구를 추가하거나, 기존 기능을 향상시키거나, 문서를 개선하고 싶으시면 여러분의 의견이 중요합니다.
다른 MCP 서버 및 구현 패턴의 예시는 다음을 참조하세요: https://github.com/modelcontextprotocol/servers
PR(Pull Request)을 환영합니다! mcp-server-time을 더욱 강력하고 유용하게 만들기 위한 새로운 아이디어, 버그 수정 또는 개선 사항을 자유롭게 기여해 주세요.
라이선스
mcp-server-time은 MIT 라이선스에 따라 라이선스가 부여됩니다. 이는 MIT 라이선스의 약관 및 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있음을 의미합니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.