batteryshark

DateTime MCP Server

by batteryshark

開発ツール

Provides timezone-aware date and time information with configurable time formats and timezone support. Enables users to get current date and time in their preferred timezone and format through simple MCP tools.

GitHubで見る

DateTime MCP Server

A simple MCP server that provides timezone-aware date and time information.

Tools

get_current_date(include_weekday=False) - Returns current date in ISO format (YYYY-MM-DD) with optional weekday
get_current_time() - Returns current time in configured format

Configuration

Set these environment variables (for stdio) or headers (for HTTP):

DEFAULT_TZ - Timezone identifier (e.g., "America/New_York", "Europe/London", "UTC")
TIMEFMT - Time format: "12" for 12-hour (2:30 PM) or "24" for 24-hour (14:30)

Fallbacks

Invalid timezone → defaults to UTC
TIMEFMT not "12" → defaults to 24-hour format

Usage Examples

STDIO (default)

{
  "date-time-mcp": {
    "command": "uv",
    "args": ["run", "python", "server.py"],
    "env": {
      "DEFAULT_TZ": "America/New_York",
      "TIMEFMT": "12"
    }
  }
}

HTTP Server

{
  "date-time-mcp": {
    "url": "http://localhost:8855",
    "headers": {
      "DEFAULT_TZ": "America/New_York",
      "TIMEFMT": "24"
    }
  }
}