Simple Time MCP CLI

By Jaesun23 GitHub

Simple MCP server for time-related functions with CLI mode support

Overview

what is Simple Time MCP CLI?

Simple Time MCP CLI is a command-line interface (CLI) tool that serves as a Model Context Protocol (MCP) server for various time-related functions without the need for a separate server.

how to use Simple Time MCP CLI?

To use the Simple Time MCP CLI, install it globally using npm or clone the repository and install it locally. You can run it directly from the terminal or configure it with applications like Claude or Cursor.

key features of Simple Time MCP CLI?

Provides current time information across different time zones.
Formats date and time according to user specifications.
Calculates the difference between two dates.
Allows adding or subtracting time from specific dates.
Converts time between various time zones.

use cases of Simple Time MCP CLI?

Checking the current time in different cities.
Formatting dates for reports or applications.
Calculating time differences for scheduling meetings across time zones.
Adding or subtracting time for project deadlines.
Converting time zones for travel planning.

FAQ from Simple Time MCP CLI?

Can I use Simple Time MCP CLI without installing a server?

Yes! It operates in CLI mode, so no separate server is needed.

How do I specify a different time zone?

Use the --timezone option followed by the desired time zone, e.g., --timezone "Asia/Seoul".

What formats can I use for date and time?

You can specify formats using the --format option, such as 12-hour or 24-hour formats.

Content

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

No tools information available.

No content found.