Mcp_time_workdays_node

@tanranv5

About Mcp_time_workdays_node

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "time-and-workdays-node": {
      "command": "npx",
      "args": [
        "mcp-time-workdays-node"
      ],
      "env": {}
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mcp_time_workdays_node?

A Model Context Protocol (MCP) Node.js server that provides current time in a specified timezone with custom formatting, and retrieves official workdays, holidays, and makeup workdays for a given year/month using free online data sources (Timor and NateScarlet holiday-cn, no API key required). Designed for MCP-compatible clients like Claude Desktop.

How to use Mcp_time_workdays_node?

Requires Node.js >= 18.17. Install globally via npm install -g mcp-time-workdays-node or run directly with npx mcp-time-workdays-node. Configure as an MCP server in your client's config (e.g., claude_desktop_config.json) using the command npx mcp-time-workdays-node. The server exposes two tools: get_current_time and get_workdays_from_api, both communicating via stdio.

Key features of Mcp_time_workdays_node

Two tools: get current time (any timezone, custom format) and query workdays/holidays by year/month
Two free online data sources: Timor (default) and NateScarlet holiday-cn (with CDN fallback)
Unified output as MCP text content for strict client compatibility
Requires only Node 18+ and the MCP SDK; no API keys or extra dependencies

Use cases of Mcp_time_workdays_node

Display the current time in any IANA timezone with custom formatting
Retrieve Chinese official workdays, holidays, and makeup workdays for a specific month/year
Integrate time and workday queries into an MCP client for automation or productivity

FAQ from Mcp_time_workdays_node

Why is the output always `text` type?

To improve MCP client compatibility, the server returns all tool results as text content (JSON string for workdays, plain text for time).

How does the `tz` parameter affect workday calculation?

The tz parameter only determines the default year/month when those arguments are omitted; it does not affect the workday logic itself (which uses local/official rules).

What does the `timeout` parameter do?

It sets the HTTP request timeout in seconds. Increase it if network fluctuations cause timeouts when fetching holiday data.

Frequently asked questions

Why is the output always `text` type?

To improve MCP client compatibility, the server returns all tool results as `text` content (JSON string for workdays, plain text for time).

How does the `tz` parameter affect workday calculation?

The `tz` parameter only determines the default year/month when those arguments are omitted; it does not affect the workday logic itself (which uses local/official rules).