MCP Time & Workdays Node

You run a Node-based MCP server that provides the current time in any time zone and pulls official workdays, holidays, and makeup workdays from online sources. It outputs results in a consistent text format suitable for MCP clients, and requires only Node.js 18+.

How to use

You connect to this MCP server from an MCP-compatible client to retrieve two kinds of information: the current time for a given zone and a month’s workdays, holidays, and makeup workdays. Use the provided stdio endpoints to call the server’s tools, and read the returned text content to display results in your client.

How to install

Prerequisites: Node.js >= 18.17 and a MCP-compatible client that can connect via stdio or an MCP URL.

# Option 1: Install and run via NPX (recommended)
npm install -g mcp-time-workdays-node
npx mcp-time-workdays-node

# Option 2: Run from source (local development)
# 1) Clone the project
git clone https://github.com/tanranv5/mcp_time_workdays_node.git
cd mcp-time-workdays-node

# 2) Install dependencies
npm install

# 3) Run the server
node mcp_time_workdays_node.mjs
# or
npm start

Additional notes and configuration

This server exposes two MCP tools via stdio. You don’t need to modify code to start using it; you configure your MCP client to run the provided commands and connect to the server’s stdio interface.

Data sources are used to compute workdays for a given year and month. The defaults and alternatives are described in the data source notes, including how holidays and makeup days are detected.

Available tools and how they work

The server provides two tools: get_current_time and get_workdays_from_api. You call these tools from your MCP client and receive a text response that you can display or further format.

Data sources and behavior

Default online source: Timor annual aggregation API. Optional free backup: NateScarlet holiday-cn via GitHub Raw, with CDN fallback. The tools return workdays, holidays, and makeup_workdays for a given month, using a consistent rule set.

Examples of usage patterns

When you run the server, you can use a client to request the current time for a specific timezone, or to fetch a given year/month’s workdays data. The client receives plain text representations suitable for display.

Available tools

get_current_time

Returns the current time in a specified IANA time zone or local time, formatted as a string. Input: tz and fmt; Output: text with the formatted time.

get_workdays_from_api

Fetches official workdays data for a given year and month from the Timor API or NateScarlet data source. Outputs a JSON string containing provider, year, month, workdays, holidays, and makeup_workdays.