Skip to main content
Glama
very99

GetUTC MCP Server

by very99

GetUTC MCP Server

English | 中文


English

A simple and reliable MCP (Model Context Protocol) server that provides accurate UTC time from multiple verified sources. Ready to use out of the box - just clone and configure!

✨ Features

  • Multiple Time Sources: Verified against 4 reliable sources for accuracy

    • WorldClockAPI (JSON API)

    • HTTP Date headers from WorldClock, Google, and GitHub

  • Multiple Formats: ISO, timestamp, readable, date-only, time-only

  • Pre-built: Ready to use without compilation

  • Reliable: Automatic fallback between sources

🚀 Quick Start

  1. Clone the repository

    git clone https://github.com/very99/getutc-mcp.git
    cd getutc-mcp
  2. Configure your MCP client

    Add to your MCP configuration file:

    For Amazon Q CLI (~/.aws/amazonq/mcp.json):

    {
      "mcpServers": {
        "getutc": {
          "command": "node",
          "args": ["/path/to/getutc-mcp/dist/index.js"],
          "timeout": 30000
        }
      }
    }

    For Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

    {
      "mcpServers": {
        "getutc": {
          "command": "node",
          "args": ["/path/to/getutc-mcp/dist/index.js"]
        }
      }
    }
  3. Start using

    Ask your MCP client:

    • "What's the current UTC time?"

    • "Get UTC timestamp"

    • "Show today's date"

📖 Tool Reference

Tool Name: get_utc_time

Parameters:

  • format (optional): Output format

    • "iso" (default): ISO 8601 format (2025-06-21T16:18:14.000Z)

    • "timestamp": Unix timestamp (1734789494)

    • "readable": Human readable (Saturday, June 21, 2025 at 4:18:14 PM UTC)

    • "date-only": Date only (2025-06-21)

    • "time-only": Time only (16:18:14)

🔧 Requirements

  • Node.js (version 14 or higher)

  • MCP-compatible client (Amazon Q CLI, Claude Desktop, etc.)

📁 Project Structure

getutc-mcp/
├── dist/           # Pre-built files (ready to use)
│   └── index.js    # Main server file
├── src/            # Source code
├── package.json    # Dependencies
└── README.md       # This file

🤝 Contributing

Feel free to submit issues and pull requests!

📄 License

MIT License


Related MCP server: chuk-mcp-time

中文

一个简单可靠的 MCP (Model Context Protocol) 服务器,通过多个验证源提供准确的 UTC 时间。开箱即用 - 只需克隆和配置!

✨ 特性

  • 多时间源: 通过4个可靠源验证确保准确性

    • WorldClockAPI (JSON API)

    • WorldClock、Google、GitHub 的 HTTP Date 头

  • 多种格式: ISO、时间戳、可读格式、仅日期、仅时间

  • 预编译: 无需编译即可使用

  • 可靠性: 源之间自动故障转移

🚀 快速开始

  1. 克隆仓库

    git clone https://github.com/very99/getutc-mcp.git
    cd getutc-mcp
  2. 配置你的 MCP 客户端

    添加到你的 MCP 配置文件:

    Amazon Q CLI (~/.aws/amazonq/mcp.json):

    {
      "mcpServers": {
        "getutc": {
          "command": "node",
          "args": ["/path/to/getutc-mcp/dist/index.js"],
          "timeout": 30000
        }
      }
    }

    Claude Desktop (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

    {
      "mcpServers": {
        "getutc": {
          "command": "node",
          "args": ["/path/to/getutc-mcp/dist/index.js"]
        }
      }
    }
  3. 开始使用

    询问你的 MCP 客户端:

    • "现在的UTC时间是多少?"

    • "获取UTC时间戳"

    • "显示今天的日期"

📖 工具参考

工具名称: get_utc_time

参数:

  • format (可选): 输出格式

    • "iso" (默认): ISO 8601 格式 (2025-06-21T16:18:14.000Z)

    • "timestamp": Unix 时间戳 (1734789494)

    • "readable": 人类可读格式 (Saturday, June 21, 2025 at 4:18:14 PM UTC)

    • "date-only": 仅日期 (2025-06-21)

    • "time-only": 仅时间 (16:18:14)

🔧 系统要求

  • Node.js (版本 14 或更高)

  • 兼容 MCP 的客户端 (Amazon Q CLI, Claude Desktop 等)

📁 项目结构

getutc-mcp/
├── dist/           # 预编译文件 (可直接使用)
│   └── index.js    # 主服务器文件
├── src/            # 源代码
├── package.json    # 依赖项
└── README.md       # 本文件

🤝 贡献

欢迎提交问题和拉取请求!

📄 许可证

MIT 许可证


Troubleshooting | 故障排除

English: If you encounter issues, make sure:

  • Node.js is installed and accessible

  • The path in your MCP configuration is correct and absolute

  • Your MCP client supports the MCP protocol

中文: 如果遇到问题,请确保:

  • Node.js 已安装且可访问

  • MCP 配置中的路径正确且为绝对路径

  • 你的 MCP 客户端支持 MCP 协议

Available Tools

1 tool
get_utc_timeA

Get accurate UTC time from multiple reliable sources

ParametersJSON Schema
NameRequiredDescriptionDefault
formatNoTime formatiso

TDQS

A3.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions 'multiple reliable sources' hinting at redundancy or failover, but does not disclose potential latency, error handling, authentication requirements, or the structure of the response. It doesn't state whether the operation is read-only (though 'get' implies it) or any side effects. Given the lack of annotations, this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that is front-loaded with the core action ('Get accurate UTC time') and includes only necessary detail. There is no fluff or redundant information, making it highly efficient for an agent to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple with one optional parameter and no output schema. The description clearly states what it does, but it does not describe the return value structure or any error conditions. An agent might not know if the response is a formatted string, object, or something else. While the format parameter implies the output format, the lack of specification about the response shape leaves a completeness gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100% – the 'format' parameter is fully described with its enum values and default. The description adds no additional meaning about the parameter beyond what the schema already provides. Therefore, the baseline score of 3 is appropriate, as the schema does the heavy lifting and the description adds no extra value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Get') and a clear resource ('accurate UTC time'), and adds 'from multiple reliable sources' which clarifies the purpose and distinguishes it from any potential simple time lookups. Since there are no sibling tools to differentiate, this is unambiguous and immediately understandable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description clearly implies the tool is for retrieving UTC time accurately, which sets the context for when to use it. With no sibling tools, there are no alternative comparisons needed, but it does not explicitly state exclusions or when not to use it. However, the purpose is explicit enough that an agent can infer the intended usage, so it earns a 4.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.0
    • First observedget_utc_time

TDQS

A3.6/5.0

Scored across 1 tool

Disambiguation5/5

There is only one tool, so there is no possibility of confusion between tools. The tool's purpose is clear and distinct.

Naming Consistency4/5

The single tool name follows a clear verb_noun pattern ('get_utc_time'), which is consistent and descriptive. With only one tool, consistency is basically perfect, though the sample size is too small to fully evaluate a pattern.

Tool Count2/5

A single tool for fetching UTC time is extremely minimalcars could be argued as a simple utility, but it feels under-scoped for a server. Most MCP servers offer a set of related operations, so one tool is very thin and likely not worth the overhead.

Completeness2/5

The domain is time retrieval, but a single 'get time' tool provides no additional functionality like timezone conversion, formatting options, or historical time data. While it fulfills the basic need, it is severely limited and lacks common related operations.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides accurate time information from Network Time Protocol (NTP) servers with timezone support and security filtering. Features whitelist-based server approval, blocks unauthorized sources, and delivers structured time output with fallback mechanisms.
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Provides high-accuracy time information by querying multiple NTP servers for consensus time, and comprehensive timezone support using IANA tzdata for conversions, DST handling, and clock drift detection independent of system time.
    7
    3
    Apache 2.0
  • A
    license
    Not graded
    quality
    D
    maintenance
    A lightweight Model Context Protocol server that provides current UTC time in various formats, including ISO 8601 and Unix timestamps. It is designed for seamless integration with Cursor IDE to provide consistent time-related capabilities across all development projects.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables retrieval of accurate current time from NTP servers with timezone conversion and structured output, falling back to local time if NTP is unavailable.
    MIT