날짜-시간 도구 MCP

날짜-시간 조작 및 시간대 변환을 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다.

개요

이 MCP 서버는 시간대 변환, 날짜 변경(산술), 현재 날짜-시간 및 시간대 가져오기를 포함하여 날짜-시간 문자열을 다루기 위한 일련의 도구를 제공합니다. 강력하고 표준화된 날짜-시간 작업이 필요한 애플리케이션이나 에이전트의 백엔드 유틸리티로 사용하도록 설계되었습니다.

라이브 배포: https://date-time-tools.iabhishek.workers.dev/mcp

Related MCP server: Time MCP Server

아키텍처

이 서버는 Cloudflare Workers에서 실행되며 Streamable HTTP 전송(레거시 SSE 엔드포인트도 노출됨)을 사용합니다. 세션별 상태는 Cloudflare의 agents McpAgent 래퍼를 통해 Durable Object에 의해 백업됩니다.

엔드포인트:

• POST/GET/DELETE /mcp — Streamable HTTP 전송. mcp-session-id 헤더를 통해 세션 추적.

• GET /sse, POST /sse/message — 이전 클라이언트를 위한 레거시 SSE 전송.

로컬 개발

npm install
npm run dev   # wrangler dev — serves at http://127.0.0.1:8787/mcp

Cloudflare에 배포

수동

일회성 설정:

npx wrangler login

배포:

npm run deploy

Wrangler가 공개 URL을 출력합니다. 이 프로젝트의 경우 https://date-time-tools.iabhishek.workers.dev/mcp입니다. Workers 무료 플랜이 이 서버를 지원합니다(일일 10만 요청; Durable Objects 무료 티어는 세션 저장소를 지원합니다).

자동화 (GitHub Actions)

.github/workflows/deploy.yml은 main에 푸시할 때마다(그리고 수동 workflow_dispatch 시) 배포합니다. 두 개의 저장소 시크릿을 구성하세요:

• CLOUDFLARE_API_TOKEN — https://dash.cloudflare.com/profile/api-tokens에서 Edit Cloudflare Workers 템플릿을 사용하여 생성

• CLOUDFLARE_ACCOUNT_ID — Workers & Pages 대시보드 사이드바에서 확인 가능

MCP 클라이언트와의 통합

Claude Code

claude mcp add date-time-tools --transport http https://date-time-tools.iabhishek.workers.dev/mcp

모든 프로젝트에 등록하려면 --scope user를 추가하고, 공동 작업자와 공유되는 .mcp.json을 커밋하려면 --scope project를 추가하세요. claude mcp list로 확인하고, Claude Code 내에서 /mcp를 실행하여 상태와 도구를 검사하세요.

일반 Streamable HTTP 클라이언트

Streamable HTTP 전송을 지원하는 클라이언트를 구성하여 배포된 URL을 가리키도록 하세요:

{
  "mcpServers": {
    "date-time-tools": {
      "url": "https://date-time-tools.iabhishek.workers.dev/mcp"
    }
  }
}

stdio만 지원하는 클라이언트의 경우 mcp-remote를 사용하여 브리지하세요:

{
  "mcpServers": {
    "date-time-tools": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://date-time-tools.iabhishek.workers.dev/mcp"]
    }
  }
}

사용 가능한 도구

이 MCP 서버는 LLM을 위해 다음 도구를 제공합니다:

• convertTimezones: 날짜-시간 문자열을 한 시간대에서 다른 시간대로 변환합니다.

• mutateDate: 날짜-시간 문자열에서 일, 시간, 분, 월 또는 연도를 더하거나 뺍니다.

• currentDateTimeAndTimezone: 현재 날짜, 시간 및 시간대를 가져옵니다.

🧪 MCP Inspector로 테스트

npm run dev를 실행한 다음, 다른 터미널에서:

npx -y @modelcontextprotocol/inspector

Streamable HTTP 전송을 선택하고 URL로 http://127.0.0.1:8787/mcp를 사용하세요.

기능

• 시간대 변환
  Luxon 호환 형식을 사용하여 날짜-시간 문자열을 한 IANA 시간대에서 다른 시간대로 변환합니다.

• 날짜 변경
  날짜-시간 문자열에서 일, 시간, 분, 월 또는 연도를 더하거나 뺍니다.

• 현재 날짜-시간 및 시간대
  사용자/시스템의 현재 날짜, 시간 및 시간대를 검색합니다.