Unix Timestamps MCP

一個輕量級MCP服務器，提供ISO 8601日期時間字符串與Unix時間戳的轉換功能。

開發者工具研究與數據 #時間轉換 #ISO8601 #Unix時間戳 #MCP服務本地 .JavaScript

評分 : 2.5分

下載量 : 6

更新時間 : 2025-04-28

What is Unix Timestamps MCP Server?

This server provides a simple tool to convert standard date/time formats (ISO 8601) into Unix timestamps - the number of seconds since January 1, 1970. It's particularly useful when you need to work with timestamps in programming or data analysis.

How to use this service?

After installation, you can access the conversion tool through compatible MCP clients like Claude Desktop. Simply send a properly formatted date string to get the corresponding Unix timestamp.

When to use this service?

Ideal for developers, data analysts, or anyone needing quick timestamp conversions without writing custom code. Useful for logging systems, API development, or when working with time-sensitive applications.

Key Features

ISO 8601 to Unix TimestampAccurately converts standard ISO 8601 date/time strings (like '2024-07-26T10:00:00Z') to Unix timestamps (seconds since epoch).

Timezone AwarenessCorrectly handles timezone offsets in input strings (e.g., '+02:00' or 'Z' for UTC).

Input ValidationAutomatically checks if input strings are valid dates before conversion.

Pros and Cons

Advantages

Lightweight and fast conversion without external dependencies

Simple integration with MCP-compatible clients

Clear error messages for invalid inputs

Handles various ISO 8601 formats including timezone offsets

Limitations

Limited to ISO 8601 format inputs (won't parse other date formats)

JavaScript Date object limitations apply (e.g., year range 100-275755)

No batch processing - converts one date at a time

Getting Started

Install Node.js

Ensure you have Node.js version 18 or later installed on your system.

Configure your MCP client

Add the server configuration to your client settings (like Claude Desktop).

Start using the conversion tool

Invoke the tool with your ISO 8601 date string to get the Unix timestamp.

Practical Examples

Basic UTC ConversionConvert a UTC date/time to timestamp

Timezone Offset HandlingConvert a date with timezone offset

Frequently Asked Questions

What date formats are supported?

What happens if I provide an invalid date?

Can I convert multiple dates at once?

What's the maximum/minimum year supported?

Additional Resources

ISO 8601 Format Reference

Detailed explanation of ISO 8601 date/time format standards

Unix Time Explained

Interactive tool and explanation of Unix timestamps

GitHub Repository

Source code and issue tracking for this MCP server

🚀 Unix 時間戳 MCP 服務器

這是一個輕量級的 MCP 服務器，主要功能是將 ISO 8601 日期/時間字符串轉換為 Unix 時間戳，為相關開發工作提供便利。

🚀 快速開始

此服務器旨在將 ISO 8601 日期/時間字符串轉換為 Unix 時間戳，使用前需完成安裝與配置。

✨ 主要特性

ISO 8601 到 Unix 時間戳轉換：提供 iso8601_to_unix 工具，可將標準 ISO 8601 日期/時間字符串轉換為 Unix 時間戳（從紀元開始的秒數）。
輸入驗證：進行基本檢查，確保輸入字符串是 JavaScript 的 Date 解釋器可以識別的有效日期。
錯誤處理：若輸入字符串不是有效的 ISO 8601 日期/時間，會返回錯誤消息。

📦 安裝指南

先決條件

Node.js（推薦使用版本 18 或更高）
npm 或 npx（通常隨 Node.js 一起提供）

客戶端配置（Claude Desktop）

要在與客戶端如 Claude Desktop 一起使用此服務器，請將以下配置添加到客戶端的設置文件中（例如 claude_desktop_config.json）：

{
  "mcpServers": {
    "unix_timestamps_mcp": {
      "command": "npx",
      "args": ["-y", "github:Ivor/unix-timestamps-mcp"]
    }
  }
}

💻 使用示例

此服務器提供了可通過 MCP 客戶端訪問的工具。

基礎用法

工具：`iso8601_to_unix(iso8601: string)`

將 ISO 8601 格式的日期/時間字符串轉換為 Unix 時間戳（紀元開始的秒數）。

輸入參數：iso8601 (string) - 在 ISO 8601 格式下的日期/時間字符串（例如，"2024-07-26T10:00:00Z"，"2024-07-26T12:00:00+02:00"）。
輸出：包含計算出的 Unix 時間戳和確認解析日期的文字。示例：

Unix 時間戳：1721988000

原始 ISO8601：2024-07-26T10:00:00Z
解析為：Fri, 26 Jul 2024 10:00:00 GMT

錯誤處理：如果輸入字符串不是有效的 ISO 8601 日期/時間，則返回錯誤消息。

高級用法

在 Claude Desktop 中使用示例

按照安裝部分所示配置服務器。
在提示中使用 iso8601_to_unix 工具：
- "將 '2023-03-15T12:00:00Z' 轉換為 Unix 時間戳：iso8601_to_unix(iso8601: '2023-03-15T12:00:00Z')"
- "2024-01-01T00:00:00-05:00 的 Unix 時間戳是多少？ iso8601_to_unix(iso8601: '2024-01-01T00:00:00-05:00')"