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
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.
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 implementationuuid: 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.