使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，专注于提供日期时间转换功能。它通过 MCP 协议与客户端通信，允许客户端调用工具将 ISO 8601 格式的日期时间字符串转换为 Unix 时间戳。

主要功能点

ISO 8601 到 Unix 时间戳转换: 提供 'iso8601_to_unix' 工具，可以将标准的 ISO 8601 格式日期时间字符串转换为 Unix 时间戳（自 epoch 以来的秒数）。
输入验证: 对输入字符串进行基本的验证，确保其可以被 JavaScript 的 'Date' 对象解析为有效的日期。
错误处理: 如果输入字符串不是有效的 ISO 8601 日期时间，服务器会返回错误信息。

安装步骤

安装 Node.js: 确保你的系统上安装了 Node.js (版本 18 或更高)。
客户端配置: 无需手动安装服务器代码，MCP 客户端 (如 Claude Desktop) 将在需要时自动下载和运行服务器。

服务器配置

为了让 MCP 客户端 (如 Claude Desktop) 能够连接到 'unix-timestamps-mcp' 服务器，你需要在客户端的配置文件中添加以下服务器配置信息。这个配置告诉客户端如何启动和运行该 MCP 服务器。

{
  "mcpServers": {
    "unix_timestamps_mcp": {  // 服务器名称，客户端使用此名称引用
      "command": "npx",      // 启动服务器的命令，这里使用 npx 运行 npm 包
      "args": ["-y", "github:Ivor/unix-timestamps-mcp"] // 命令参数，-y 表示自动确认安装，github:Ivor/unix-timestamps-mcp 指向 GitHub 仓库地址，npx 会自动下载并运行该仓库
    }
  }
}

配置说明:

'"unix_timestamps_mcp"': 这是你为该服务器定义的名称。在客户端配置和后续使用中，你将使用这个名称来引用该服务器。
'"command": "npx"': 指定用于启动服务器的命令为 'npx'。'npx' 是 npm 包管理器的一部分，用于执行 npm 包。
'"args": ["-y", "github:Ivor/unix-timestamps-mcp"]': 指定传递给 'npx' 命令的参数。
- '"-y"': 'npx' 的参数，表示自动同意安装可能需要的 npm 包，避免在运行时出现交互式提示。
- '"github:Ivor/unix-timestamps-mcp"': 指定要运行的 npm 包的来源是 GitHub 仓库 'Ivor/unix-timestamps-mcp'。'npx' 会自动从 GitHub 下载该仓库的代码并尝试运行。

注意: 客户端 (如 Claude Desktop) 会负责读取并应用以上配置。你只需要将这段 JSON 配置添加到你的客户端配置文件中即可。不需要手动执行 'npm install' 或其他安装步骤。

基本使用方法

配置客户端: 将上述服务器配置添加到你的 MCP 客户端 (如 Claude Desktop) 的配置文件中。
在 Prompt 中调用工具: 在你的 LLM 客户端的 Prompt 中，你可以使用以下语法调用 'iso8601_to_unix' 工具，将 ISO 8601 格式的日期时间字符串转换为 Unix 时间戳：
```
iso8601_to_unix(iso8601: '你的ISO 8601日期时间字符串')
```
示例:
- 将 '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')'
客户端会将你的请求发送到 'unix-timestamps-mcp' 服务器，服务器执行转换工具并将结果返回给客户端，最终显示在 LLM 的回复中。

关键词