MCP.so
Sign In
M

Mcp_time_workdays_node

@tanranv5

Repository

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": {}
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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

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

Basic information

Category

Productivity

Transports

stdio

Author

tanranv5

Submitted by

tanran

More Productivity MCP servers

AppleScript MCP Server (Dual access: python and node.js)

peakmojo

MCP server that execute applescript giving you full control of your Mac

461

Desktop Commander

wonderwhy-er

This is MCP server for Claude that gives it terminal control, file system search and diff file editing capabilities

6.3K

Sitespeak Claude Plugin

sitespeakai

Manage your SiteSpeakAI chatbot from Claude Code - a plugin and MCP server for optimizing chatbots in plain English.

ATLAS: Task Management System

cyanheads

A Model Context Protocol (MCP) server for ATLAS, a Neo4j-powered task management system for LLM Agents - implementing a three-tier architecture (Projects, Tasks, Knowledge) to manage complex workflows. Now with Deep Research.

475

twocents

twocents-page

Human feedback for AI agents — remote MCP server at twocents.page/mcp (share_page / get_feedback)