# 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:**

```json
{
  "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

```bash
# 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:

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