Simple Time MCP CLI

간단한 시간 관련 기능을 제공하는 MCP(Model Context Protocol) 서버입니다. 이 버전은 일회성 CLI 모드로 작동하므로 서버를 별도로 실행할 필요가 없습니다.

설치 방법

글로벌 설치 (권장)

npm install -g Jaesun23/simple-time-mcp-cli

또는 로컬 저장소에 직접 클론하여 설치:

git clone https://github.com/Jaesun23/simple-time-mcp-cli.git
cd simple-time-mcp-cli
npm install
npm install -g .

Claude/Cursor 설정

Claude 데스크톱 앱 설정

claude_desktop_config.json 파일에 다음과 같이 추가하세요:

{
  "mcpServers": {
    "time": {
      "command": "simple-time-mcp-cli",
      "args": ["--mcp"]
    }
  }
}

Cursor 설정

Cursor 설정에도 동일하게 추가하세요:

{
  "mcpServers": {
    "time": {
      "command": "simple-time-mcp-cli",
      "args": ["--mcp"]
    }
  }
}

고급 설정 옵션

원하는 타임존과 형식을 지정할 수 있습니다:

{
  "mcpServers": {
    "time": {
      "command": "simple-time-mcp-cli",
      "args": ["--mcp", "--timezone", "Asia/Seoul", "--format", "24h"]
    }
  }
}

사용 가능한 옵션:

| 옵션 | 설명 | 기본값 | 예시 | |------|------|--------|------| | --timezone, --tz | 기본 타임존 설정 | UTC | --timezone "Asia/Seoul" | | --format, -f | 시간 형식 (12h/24h) | 24h | --format "12h" | | --date-format | 날짜 표시 형식 | YYYY-MM-DD | --date-format "MM/DD/YYYY" |

주요 타임존 목록:

Asia/Seoul - 한국
Asia/Tokyo - 일본
America/New_York - 미국 동부
America/Los_Angeles - 미국 서부
Europe/London - 영국
Europe/Paris - 프랑스
Australia/Sydney - 호주 시드니
UTC - 협정 세계시

주요 기능

이 MCP 서버는 다음과 같은 시간 관련 기능을 제공합니다:

현재 시간 - 다양한 타임존의 현재 시간 정보
날짜 포맷팅 - 원하는 형식으로 날짜/시간 표시
날짜 차이 계산 - 두 날짜 간의 차이 계산
날짜 더하기/빼기 - 특정 날짜에 시간 추가/제거
타임존 변환 - 다양한 타임존 간 변환 및 정보

사용 방법

CLI 모드로 직접 사용

터미널에서 아래와 같이 실행할 수 있습니다:

simple-time-mcp-cli

특정 타임존 지정:

simple-time-mcp-cli --timezone "Asia/Seoul"

Claude/Cursor에서 사용

Claude나 Cursor에서 다음과 같이 시간 관련 질문을 할 수 있습니다:

"현재 시간이 어떻게 되나요?"
"서울과 뉴욕의 시간 차이는 얼마인가요?"
"다음 주 월요일은 며칠인가요?"
"크리스마스까지 며칠 남았나요?"

특정 타임존 요청 예시

"지금 도쿄 시간이 어떻게 되나요?"
"파리는 지금 몇 시인가요?"
"서울 시간으로 내일 오전 9시는 뉴욕 시간으로 몇 시인가요?"

문제 해결

1. 권한 문제 발생 시

파일에 실행 권한을 부여합니다:

chmod +x $(which simple-time-mcp-cli)

2. 명령어를 찾을 수 없는 경우

전역 설치 경로를 확인합니다:

npm list -g --depth=0

이 경로가 PATH 환경 변수에 포함되어 있는지 확인하세요.

라이선스

MIT