uuid-mcp

# UUID MCP Tool A simple Model Context Protocol (MCP) server that provides a tool to generate UUIDs. ## Installation ### Install from PyPI (Recommended) ```bash pip install uuid-mcp ``` ### Install from source 1. Clone or download this repository 2. Install the package: ```bash pip install . ``` Or install in development mode: ```bash pip install -e . ``` ### Install from local directory If you have the package locally: ```bash pip install /path/to/uuid-mcp ``` ## Usage After installation, you can run the MCP server using the `uuid-mcp` command: ```bash 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: ```json { "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: ```bash which uuid-mcp ``` Or use Python's `-m` flag: ```json { "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](PUBLISHING.md) for instructions on how to publish this package to PyPI.