home / mcp / uuid mcp server

UUID MCP Server

Provides a simple MCP service that generates UUIDs on demand for unique identification.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aki-kii-mcp-uuid": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/mcp-uuid",
        "run",
        "get-uuid.py"
      ]
    }
  }
}

This MCP server provides a simple service that generates UUIDs on demand. It’s useful for applications that need unique identifiers without implementing their own UUID generator logic. You can run it locally and access UUIDs from your MCP client or tooling that supports MCP servers.

How to use

You interact with this server through an MCP client or interface that can call tools exposed by an MCP server. The server offers a get_uuid tool that returns a newly generated UUID each time you request it. To enable usage, add the server to your client’s MCP configuration and then trigger the get_uuid tool by asking Claude Desktop (or your MCP client) to generate a random ID.

How to install

Prerequisites you need before installing: - Python 3.10 or higher - MCP package version 1.2.0 or higher - Claude Desktop installed on your system Install dependencies for the MCP server using the following command:

uv pip sync

Configuration and usage notes

To enable the UUID MCP server in Claude Desktop, add a new MCP server entry under the mcpServers configuration. Place the following entry inside the existing mcpServers object:

{
  "mcpServers": {
    "uuid": {
      "command": "/path/to/uv",
      "args": [
          "--directory",
          "/path/to/mcp-uuid",
          "run",
          "get-uuid.py"
      ]
    }
  }
}

How to run and generate UUIDs

After configuration, you can request a new UUID by prompting Claude Desktop to generate an ID. For example, you can type a natural-language request like “Generate a random ID.” Claude will call the MCP tool to produce a fresh UUID and return it to you. The server’s UUID is generated on every request, ensuring uniqueness.

Notes on usage details

Make sure to use the absolute path to the uv executable in your configuration. The example uses "/path/to/uv". The directory parameter should point to the location where the UUID generator script (get-uuid.py) resides. The system will execute the script to obtain a new UUID on each request.

Example UUID output

A generated UUID example looks like: eccf34af-1617-4f61-b148-e900bc1d3d00

Available tools

get_uuid

Generates and returns a new UUID with no input parameters; used to obtain unique identifiers on demand.