MCP DateTime Server

MCP Current Time Server

A minimal Model Context Protocol (MCP) server that provides current local datetime information. This server serves as a blueprint for building simple, single-purpose MCP servers.

Features

current-time: Get current local datetime in a simple single-line format

Quick Start

Prerequisites

Bun runtime

Installation

# Clone and navigate to project
git clone <repository-url>
cd mcp-datetime

# Install dependencies
bun install

# Make executable
chmod +x src/index.ts

Run Server

bun run src/index.ts

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "datetime": {
      "command": "bun",
      "args": ["/absolute/path/to/mcp-datetime/src/index.ts"]
    }
  }
}

VS Code MCP Extension

{
  "mcp": {
    "servers": {
      "datetime": {
        "command": "bun",
        "args": ["/absolute/path/to/mcp-datetime/src/index.ts"]
      }
    }
  }
}

Usage Example

{
  "tool": "current-time",
  "parameters": {
    "timezone": "America/New_York"
  }
}

Response:

Monday, January 15, 2024 at 2:30:45 PM EST

Development

Scripts

# Run server
bun run src/index.ts

# Run tests
bun test

# Build for production
bun build src/index.ts --outdir=dist

Project Structure

src/
├── index.ts              # Main entry point
├── server/
│   └── datetime-server.ts # MCP server configuration
├── tools/
│   ├── current-time.ts    # Current time tool
│   └── current-time.test.ts # Unit tests
├── utils/
│   └── datetime-utils.ts  # Shared utilities
└── types/
    └── datetime.types.ts  # Type definitions

Extending This Blueprint

This minimal server is designed to be easily extended:

Add new tools: Create src/tools/new-tool.ts and register in datetime-server.ts
Add resources: Create src/resources/new-resource.ts and register in datetime-server.ts
Add validation: Use Zod schemas for input validation
Add tests: Create .test.ts files alongside your tools

Testing

Run the test suite:

bun test

Troubleshooting

Common Issues

Permission Denied: Make sure src/index.ts is executable
chmod +x src/index.ts
Timezone Issues: Ensure valid IANA timezone identifiers are used

License

MIT License - see LICENSE file for details.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Provides current local datetime information with timezone support. Serves as a minimal blueprint for building simple, single-purpose MCP servers.

Related MCP Servers

MCP Simple Timeserver
andybrandt
A
security
A
license
A
quality
An MCP server that allows checking local time on the client machine or current UTC time from an NTP server
Last updated -
2
19
Python
MIT License
Time Server
clssck
-
security
F
license
-
quality
An MCP server providing timezone conversions and time-related operations via RESTful API endpoints, featuring comprehensive error handling and timezone database integration.
Last updated -
Python
Time MCP
samay58
-
security
F
license
-
quality
A Claude Model Configuration Protocol (MCP) server that provides real-time timezone-aware date and time information.
Last updated -
Python
Date and Time MCP Server
MarcinMalczewski
-
security
F
license
-
quality
A simple Model Context Protocol (MCP) server that provides date and time functionality in any timezone, along with user profiles and personalized greeting resources.
Last updated -
Python

View all related MCP servers