ID Generator MCP Server

An MCP (Model Context Protocol) server that generates auto-incrementing unique identifiers and provides current ISO timestamps.

Overview

This MCP server provides two core tools:

1. Generate Unique ID - Generates auto-incrementing 8-digit hexadecimal identifiers with persistent state across restarts
2. ISO Date - Returns the current date and time in ISO 8601 format (UTC)

Tools

Generate Unique ID

The MCP server generates auto-incrementing 8-digit hexadecimal unique identifiers. Each ID automatically increments from the previous value, ensuring sequential uniqueness across all calls and server restarts. The counter state is persisted to disk, making it ideal for:

• Creating unique element IDs for testing and automation
• Generating sequential tracking numbers
• Assigning unique references to data entries
• Any scenario requiring guaranteed unique, sequential identifiers

Input:

{
  "count": 5  // Optional: number of IDs to generate (1-32, defaults to 1)
}

Output:

Generated 5 unique ID(s):
00000001
00000002
00000003
00000004
00000005

ISO Date

The MCP server returns the current date and time in ISO 8601 format. Each call provides the precise current timestamp in UTC timezone, useful for:

• Creating standardized timestamps for logs and records
• Generating sortable date strings
• Recording event times in a universal format
• Any scenario requiring ISO 8601 compliant timestamps

Input:

No input parameters required.

Output:

Current ISO datetime: 2025-12-10T14:23:45.678Z

Usage

Command Line

# Basic usage with stdio transport
npx @gergelyszerovay/mcp-id-date

# Enable HTTP transport for SSE
npx @gergelyszerovay/mcp-id-date --enableHttpTransport

# Enable REST API server
npx @gergelyszerovay/mcp-id-date --enableRestServer

# Custom counter file location
npx @gergelyszerovay/mcp-id-date --idCounterFile=./my-counter.txt

CLI Options

| Flag | Description | Default | | :----------------------- | :------------------------------------------------------- | :--------------------------- | | --enableHttpTransport | Enable HTTP transport for SSE | false | | --enableStdioTransport | Enable stdio transport | true | | --enableRestServer | Enable REST API server | false | | --mcpHttpPort | Port for MCP HTTP server | 3001 | | --restHttpPort | Port for REST HTTP server | 3002 | | --idCounterFile | Path to the file used for tracking the last generated ID | /workspace/last-tag-id.txt |

MCP Integration

Add this to your MCP server configuration:

{
  "mcpServers": {
    "id-generator": {
      "command": "npx",
      "args": ["-y", "@gergelyszerovay/mcp-id-date"]
    }
  }
}