🚀 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 中使用示例

1. 按照安装部分所示配置服务器。
2. 在提示中使用 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')"

📄 许可证

此项目使用 MIT License。有关详细信息，请参阅 LICENSE 文件。（如有需要请创建 LICENSE 文件或更新此部分）。