UUID MCP Provider

A simple MCP server that provides timestamp-based UUIDs on request for LLMs, delivering unique, chronologically sortable IDs.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 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": {
    "prazedotid-uuid-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/uuid-mcp/build/index.js"
      ]
    }
  }
}

You set up a small MCP server that generates timestamp-based UUIDs using UUID v7. It runs locally and can be connected to LLMs to supply unique, chronologically sortable identifiers on demand, with no input parameters needed.

How to use

You access the UUID generation capability through an MCP client by connecting to the provided MCP server. Once connected, you can request a new UUID whenever you need a unique, time-based identifier. The server exposes a single tool named generateUuid, which returns a UUID v7 string that is chronologically sortable.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

Step 1: Install dependencies.

npm install

Step 2: Build the project.

npm run build

Step 3: Start the server.

npm start

Integration with Claude Desktop involves adding an MCP server entry to your Claude Desktop configuration. You can place the following configuration in your Claude Desktop config file (adjust the path to your built index.js):

{
  "mcpServers": {
    "uuid_provider": {
      "command": "node",
      "args": ["/absolute/path/to/uuid-mcp/build/index.js"]
    }
  }
}

Integration with Claude Desktop

To complete integration, ensure Claude Desktop is restarted after updating the configuration so the UUID generation tool becomes available to you.

How It Works

This server relies on the official UUID library to generate UUID v7 identifiers. UUID v7 embeds a precise timestamp and adds randomized data to preserve uniqueness even when many IDs are produced in rapid succession. The result is a chronologically sortable, RFC-compliant UUID that minimizes the risk of collisions in distributed environments.

Dependencies

Key dependencies include the MCP SDK for server implementation and a UUID library used to generate v7 identifiers. You’ll typically also rely on TypeScript tooling during development.

Notes

The server exposes a single tool called generateUuid that you can call from your MCP client to obtain a new UUID v7 string. The sample UUID looks like 018e94d2-279b-7bd3-9289-80d1e6619670, where the initial portion contains timestamp information for chronological ordering.

Available tools

generateUuid

Generates a UUID v7 timestamp-based identifier with a Unix timestamp component, randomness to prevent collisions, and chronological sortability.