uuid-mcp

A minimal UUID utility server built for the Model Context Protocol (MCP). Generate UUIDs seamlessly through Claude Desktop and Claude Code.

Claude talks to it over stdio, gets a UUID, done.

Features

• 🆔 Generate random UUIDs (v4)
• 🔌 Easy integration with Claude Desktop and Claude Code
• ⚡ Lightweight and fast
• 🛠️ Built with TypeScript

Installation

Option 1: Install globally (simple, persistent)

npm install -g @abhishekrj02/uuid-mcp

Verify it works:

uuid-mcp

You should see:

UUID Generator MCP Server running on stdio

Claude Code setup

Claude Code does not auto-discover MCP servers. You must register it manually.

Install the Package

You can use this package without installing it globally by using npx, or install it globally for faster access.

npm install -g @abhishekrj02/uuid-mcp

Add to Claude Code

For Windows Users

claude mcp add uuid-mcp -- cmd /c npx -y @abhishekrj02/uuid-mcp

For macOS/Linux Users

claude mcp add uuid-mcp -- npx -y @abhishekrj02/uuid-mcp

Verify Installation

claude mcp list

Use It

Start a Claude Code session:

claude

Then simply ask Claude to generate a UUID:

Can you generate a UUID for me?

Claude will use the MCP server to generate a random UUID.

Claude Desktop setup

Claude Desktop does not auto-discover MCP servers. You must register it manually.

Config file location

macOS / Linux

~/.config/claude-desktop/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Add this:

{
  "mcpServers": {
    "uuid": {
      "command": "uuid-mcp"
    }
  }
}

Restart Claude Desktop after saving.

Example Usage

Once configured, just ask Claude: Generate a UUID

Development

Clone and build:

npm install
npm run build

Run locally:

node build/index.js