ID Generator

Provides auto-incrementing 8-digit hexadecimal IDs and current ISO timestamps via an MCP server.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You run a compact MCP server that generates auto-incrementing 8‑digit hexadecimal identifiers and returns the current ISO 8601 timestamp in UTC. It is designed for reliable, persistent ID generation across restarts and for timestamping events in a consistent format, making it ideal for testing, automation, and data tracking.

How to use

Install and run the ID Generator MCP Server through your MCP client. You can start with the basic setup to generate a single ID per request, or enable transports to expose additional access methods such as HTTP or a REST API.

Basic usage patterns you can adopt include generating a single ID per call, generating multiple IDs in one request, or using a persistent counter file to keep the sequence across restarts. You can also request the current timestamp in ISO 8601 format for logging and synchronization purposes.

The server exposes two core capabilities:

Generate Unique ID: returns auto-incrementing 8-digit hexadecimal IDs with persistent state.
ISO Date: returns the current UTC timestamp in ISO 8601 format.

How to install

Prerequisites: ensure you have Node.js installed on your machine. You do not need a global installation if you prefer executing via a package runner.

Basic start (stdio transport) with the MCP client:

npx @gergelyszerovay/mcp-id-date
`

Enable HTTP transport for Server-Sent Events (SSE):

npx @gergelyszerovay/mcp-id-date --enableHttpTransport
`

Enable REST API server:

npx @gergelyszerovay/mcp-id-date --enableRestServer
`

Use a custom counter file location for persistent ID state:

npx @gergelyszerovay/mcp-id-date --idCounterFile=./my-counter.txt
`

Additional notes

The MCP client can leverage the standard CLI flags to tailor the server to your environment. If you need both local and remote access methods, you can enable them as described above and connect through the corresponding MCP transport.

Available tools

Generate Unique ID

Generates auto-incrementing 8-digit hexadecimal IDs with persistent state across restarts, providing sequential uniqueness for testing, automation, and data tracking.

ISO Date

Returns the current date and time in ISO 8601 format in UTC, useful for standardized timestamps and sortable date strings.