Uuid

A simple Model Context Protocol (MCP) server that provides a tool to generate UUIDs.

Installation

Install from PyPI (Recommended)

pip install uuid-mcp

Install from source

1. Clone or download this repository
2. Install the package:

pip install .

Or install in development mode:

pip install -e .

Install from local directory

If you have the package locally:

pip install /path/to/uuid-mcp

Usage

After installation, you can run the MCP server using the uuid-mcp command:

uuid-mcp

The server will communicate via stdio and expose a generate_uuid tool that generates a random UUID (version 4) when called.

Tool

• generate_uuid: Generates a random UUID (version 4). Takes no parameters and returns a UUID string.

Adding to Cursor

To use this MCP tool in Cursor, add it to your Cursor MCP configuration:

1. Open Cursor Settings (Cmd/Ctrl + ,)

2. Navigate to "Features" → "Model Context Protocol" or search for "MCP"

3. Click "Edit Config" or open the MCP configuration file (typically located at ~/.cursor/mcp.json or in Cursor's settings)

4. Add the following configuration:

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

If uuid-mcp is not in your PATH, you can use the full path to the executable. After pip installation, you can find it with:

which uuid-mcp

Or use Python's -m flag:

{
  "mcpServers": {
    "uuid-generator": {
      "command": "python",
      "args": ["-m", "uuid_mcp.server"]
    }
  }
}

5. Restart Cursor for the changes to take effect.

Once configured, you can use the generate_uuid tool in Cursor's AI chat interface.

Publishing

For package maintainers: See PUBLISHING.md for instructions on how to publish this package to PyPI.