Unix Timestamps MCP

🚀 Unix Timestamps MCP Server

A lightweight MCP server for converting ISO 8601 date/time strings to Unix timestamps.

✨ Features

• ISO 8601 to Unix Timestamp Conversion: Provides a tool (iso8601_to_unix) to convert standard ISO 8601 date/time strings to Unix timestamps (seconds since the epoch).
• Input Validation: Performs basic checks to ensure the input string is a valid date recognizable by JavaScript's Date interpreter.
• Error Handling: Returns an error message if the input string is not a valid ISO 8601 date/time.

📦 Installation

Prerequisites

• Node.js (version 18 or higher is recommended)
• npm or npx (usually provided with Node.js)

Client Configuration (Claude Desktop)

To use this server with a client like Claude Desktop, add the following configuration to the client's settings file (e.g., claude_desktop_config.json):

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

💻 Usage Examples

This server provides tools accessible via the MCP client.

Available Tools

Tool: iso8601_to_unix(iso8601: string)

Converts an ISO 8601 formatted date/time string to a Unix timestamp (seconds since the epoch).

• Input Parameter: iso8601 (string) - A date/time string in ISO 8601 format (e.g., "2024-07-26T10:00:00Z", "2024-07-26T12:00:00+02:00").

• Output: Contains the calculated Unix timestamp and text confirming the parsed date. Example:

  Unix Timestamp: 1721988000
  
  Original ISO8601: 2024-07-26T10:00:00Z
  Parsed as: Fri, 26 Jul 2024 10:00:00 GMT
  

• Error Handling: Returns an error message if the input string is not a valid ISO 8601 date/time.

Example in Claude Desktop

1. Configure the server as shown in the Installation section.
2. Use the iso8601_to_unix tool in the prompt:
   • "Convert '2023-03-15T12:00:00Z' to a Unix timestamp: iso8601_to_unix(iso8601: '2023-03-15T12:00:00Z')"
   • "What is the Unix timestamp for 2024-01-01T00:00:00-05:00? iso8601_to_unix(iso8601: '2024-01-01T00:00:00-05:00')"

📄 License

This project is licensed under the MIT License. For more details, please refer to the LICENSE file. (Create the LICENSE file or update this section if necessary).