MCP.so
Sign In
M

MCP Time Workdays Node

@tanranv5

Basic information

Category

Productivity

Transports

stdio

Author

tanranv5

Submitted by

tanran

About MCP Time Workdays Node

No overview available yet

MCP Time Workdays Node 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": {}
    }
  }
}

MCP Time Workdays Node tools

2

获取指定时区的当前时间(支持自定义格式)

获取某月官方工作日与补班(支持 timor 与 nate 提供方)

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

Frequently asked questions

1

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).

2

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).

3

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.

Comments

More Productivity MCP servers