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

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

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

EM+x

Cubed Studios

EM+x turns your conversation into board-ready deliverables: steering-committee readouts, executive briefs, market scans, QBR decks, and program updates - each built by an agentic consulting team using your own templates

Sitespeak Claude Plugin

sitespeakai

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

Turnale

Turnale.app

Tournament software for tennis, padel, pickleball and more: fair draws, live standings, scores and dropout handling. Run recreational racket-sport tournaments from chat: schedules for americano, mexicano, round robin, g

LinkedIn Ghostwriter

ContentIn

Write LinkedIn posts in your own voice from Claude, ChatGPT, or any MCP client. ContentIn trains a personal AI on your own LinkedIn posts, then generates ideas, drafts in your voice, schedules, publishes via LinkedIn's o

RADAAR

RADAAR

Official repository bringing RADAAR's social media and content management tools to AI agents like Cursor, VS Code, and ChatGPT. Built on the agent-plugins.org standard, it connects seamlessly to the MCP server. Schedule