Datetime

🚀 MCP DateTime

A Model Context Protocol (MCP) server implemented in TypeScript, providing date, time, and timezone information for proxy systems and chat REPLs.

🚀 Quick Start

MCP DateTime is a straightforward server that implements the Model Context Protocol, offering date, time, and timezone information to AI agents and chat interfaces. It empowers AI systems to:

• Retrieve the current time from the local system clock.
• Obtain the current time in a specified timezone.
• List all available timezones.
• Access timezone information via resource URIs.

✨ Features

• Time Retrieval: Get the current time from the local system clock or a specified timezone.
• Timezone Listing: List all available timezones.
• Resource URI Access: Access timezone information through resource URIs.
• Multiple Modes: Support standard input/output mode and Server-Sent Events (SSE) mode.

📦 Installation

From npm

npm install -g mcp-datetime

From Source Code

git clone https://github.com/odgrmi/mcp-datetime.git
cd mcp-datetime
npm install
npm run build

💻 Usage Examples

Command Line

MCP DateTime can operate in two modes:

1. Standard Input/Output Mode (Default)

This mode is suitable for AI systems that support MCP protocol integration via standard input/output:

mcp-datetime

2. Server-Sent Events (SSE) Mode

This mode initiates an HTTP server that provides the MCP protocol via SSE:

mcp-datetime --sae

You can also specify a custom port and URI prefix:

mcp-datetime --sae --port=8080 --prefix=/api/datetime

Environment Variables

• PORT: Set the port for SSE mode (Default: 3000).
• URI_PREFIX: Set the URI prefix for SSE mode (Default: None).

📚 Documentation

Available Tools

MCP DateTime offers the following tools:

get-current-time

Returns the current time from the local system clock.

get-current-timezone

Returns the timezone of the current system.

get-time-in-timezone

Returns the current time in a specified timezone. Parameters:

• timezone: The timezone for which to get the current time (e.g., "America/New_York").

list-timezones

Returns a list of all available timezones.

Resource URIs

MCP DateTime also provides timezone information via resource URIs:

datetime://{timezone}

Returns the current time in the specified timezone. Example: datetime://America/New_York

datetime://list

Returns a list of all available timezones.

Common Timezones

The following common timezones are always available:

• UTC
• Europe/London
• Europe/Paris
• Europe/Berlin
• America/New_York
• America/Chicago
• America/Denver
• America/Los_Angeles
• Asia/Tokyo
• Asia/Shanghai
• Asia/Kolkata
• Australia/Sydney
• Pacific/Auckland

SSE Endpoints

In SSE mode, the following endpoints are available:

• /sse: SSE connection endpoint.
• /message: Message endpoint for client-to-server communication.
• /info: Basic server information. If a URI prefix is specified, it will be appended to all endpoints.

Integration with AI Systems

MCP DateTime can be integrated with AI systems that support the Model Context Protocol. This enables AI agents to access accurate timezone and date-time information.

🔧 Technical Details

Prerequisites

• Node.js 14.16 or higher
• npm

Setup

git clone https://github.com/odgrim/mcp-datetime.git
cd mcp-datetime
npm install

Build

npm run build

Run in Development Mode

npm run dev        # Standard input/output mode
npm run dev:sae    # SSE mode

📄 License

This project is licensed under the Mozilla Public License 2.0. For detailed information, please refer to the LICENSE file.