UUID MCP Provider

Instructions

Implementation Reference

• src/index.ts:43-61 (handler)

  Handler logic for the generateUuid tool: extracts count from arguments (default 1), generates that many UUID v7s using uuidv7(), and returns them as newline-separated text content.

  if (request.params.name === "generateUuid") {
    // Pull from params.arguments per MCP spec
    const raw = request.params.arguments?.count;
    const count = typeof raw === "number" && raw >= 1 ? raw : 1;
  
    const uuids: string[] = [];
    for (let i = 0; i < count; i++) {
      uuids.push(uuidv7());
    }
  
    return {
      content: [
        {
          type: "text",
          text: uuids.join("\n")
        }
      ]
    };
  }

• src/index.ts:22-32 (schema)

  Input schema definition for generateUuid tool: object with optional 'count' integer property (min 1).

  inputSchema: {
    type: "object",
    properties: {
      count: {
        type: "integer",
        minimum: 1,
        description: "How many UUID v7 strings to generate (defaults to 1)"
      }
    },
    additionalProperties: false
  }

• src/index.ts:14-37 (registration)

  Registers the generateUuid tool by handling ListToolsRequest and returning the tool metadata including name, description, and inputSchema.

  server.setRequestHandler(
    ListToolsRequestSchema,
    async () => {
      return {
        tools: [
          {
            name: "generateUuid",
            description: "Generate one or more UUID v7s (timestamp-based). Specify `count` to get multiple.",
            inputSchema: {
              type: "object",
              properties: {
                count: {
                  type: "integer",
                  minimum: 1,
                  description: "How many UUID v7 strings to generate (defaults to 1)"
                }
              },
              additionalProperties: false
            }
          }
        ]
      };
    }
  );

• src/index.ts:3-3 (helper)

  Imports the uuidv7 function used to generate UUIDs in the handler.

  import { v7 as uuidv7 } from "uuid";