MCP Time Server

A Model Context Protocol (MCP) server providing time-related tools with dual-mode support:

• Stdio transport for local MCP clients (via npm)
• Streamable HTTP transport for remote access (via Cloudflare Workers)

This server allows LLMs to access various date/time functions through multiple connection methods.

MCP Central Server Card: https://guide-gen.mcpcentral.io/servers/io-github-mcpcentral-io-mcp-time

Features

Provides the following MCP tools:

• current_time: Get the current date and time in specified formats and timezones.
• relative_time: Get a human-readable relative time string (e.g., "in 5 minutes", "2 hours ago").
• days_in_month: Get the number of days in a specific month.
• get_timestamp: Get the Unix timestamp (milliseconds) for a given time.
• convert_time: Convert a time between different IANA timezones.
• get_week_year: Get the week number and ISO week number for a given date.

Project Structure

mcp-time/
├── src/
│   └── index.ts      # Cloudflare Worker entry point & MCP logic
├── package.json      # Project dependencies and scripts
├── tsconfig.json     # TypeScript configuration
└── wrangler.toml     # Cloudflare Worker configuration

Installation

Option 1: Install from npm (Stdio Mode)

Install the package globally or use with npx:

# Global installation
npm install -g @mcpcentral/mcp-time

# Or use directly with npx
npx @mcpcentral/mcp-time

Option 2: Use Remote Server (HTTP Mode)

Connect directly to the deployed Cloudflare Worker:

Example:

https://mcp.time.mcpcentral.io

Usage

Stdio Transport (Local)

Configure your MCP client (e.g., Claude Desktop) to use the stdio transport:

{
  "mcpServers": {
    "time-server": {
      "command": "npx",
      "args": ["@mcpcentral/mcp-time"]
    }
  }
}

Or with global installation:

{
  "mcpServers": {
    "time-server": {
      "command": "/path/to/node/bin/mcp-time"
    }
  }
}

Streamable HTTP Transport (Remote)

Configure your MCP client to use the remote HTTP endpoint:

{
  "mcpServers": {
    "time-server": {
      "url": "https://mcp.time.mcpcentral.io",
      "transport": "streamable-http"
    }
  }
}

Development

1. Clone the Repository:

   git clone https://github.com/mcpcentral-io/mcp-time.git
   cd mcp-time
   

2. Install Dependencies:

   npm install
   

3. Build: Compile the TypeScript code:

   npm run build
   

   (This compiles src/index.ts to dist/index.js)

4. Test Locally:

   Test Stdio Mode:

   echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | node dist/index.js
   

   Test HTTP Mode (via Wrangler):

   npx wrangler dev
   

   This will start the server on http://localhost:8787. You can then test with curl or point your MCP client to this local endpoint.

Deployment

Deploy to Cloudflare Workers (HTTP Mode)

1. Configure Cloudflare:

   cp wrangler.toml.example wrangler.toml
   

   Edit wrangler.toml to configure your domain (optional).

2. Login and Deploy:

   wrangler login
   npx wrangler deploy
   

Publish to npm (Stdio Mode)

1. Build the package:

   npm run build
   

2. Publish:

   npm publish --access public
   

Connectors for Streamable HTTP Servers

NEW: Major providers have adopted the Model Context Protocol and now support Streamable HTTP servers directly. Anthropic, OpenAI, and Microsoft have all adopted this modern transport protocol.

📋 Protocol Note: Streamable HTTP is the modern replacement for the deprecated HTTP+SSE transport.

Anthropic MCP Connector

Anthropic's [MCP Connector](https://docs.anthropic.com/en/docs/agents-and

... View full README on GitHub