UUID MCP Provider

A simple Model Context Protocol (MCP) server that provides timestamp-based UUIDs whenever it's called by an LLM.

Features

• Provides a single tool: generateUuid
• Uses UUID v7 for timestamp-based unique identifiers
• Simple interface with no input parameters needed
• Easy integration with Claude and other LLMs

How It Works

This server uses the official uuid package to generate UUID v7 identifiers. UUID v7 is specifically designed to be timestamp-based while maintaining strong uniqueness guarantees:

• Incorporates a Unix timestamp in millisecond precision
• Adds randomized data to ensure uniqueness even when multiple IDs are generated in the same millisecond
• Follows the latest RFC standards for UUID generation
• Provides chronologically sortable identifiers
• Prevents collisions in distributed systems

This approach is more reliable than custom UUID implementations and eliminates the potential for duplicates even under high load.

Dependencies

• @modelcontextprotocol/sdk: For MCP server implementation
• uuid: For RFC-compliant UUID generation
• TypeScript and related tools for development

Example

When called, the tool returns a UUID v7 string that looks like:

018e94d2-279b-7bd3-9289-80d1e6619670

The first part of the UUID contains the timestamp, making these identifiers chronologically sortable while still maintaining the standard UUID format.

Installation

# Install dependencies
npm install

# Build the project
npm run build

Usage

You can run the server directly:

npm start

Integration with Claude Desktop

To integrate with Claude Desktop, add this to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Replace /absolute/path/to/uuid-mcp/build/index.js with the absolute path to your built index.js file.

After updating the configuration, restart Claude Desktop to see the UUID generation tool available.