mcp-uuidv7-generator

A Model Context Protocol (MCP) server for generating UUIDv7 strings.

Created with vibe-coding using trae.ai

Features

• Get a single UUIDv7 string.
• Get a batch of UUIDv7 strings.

Usage

To use this server with an MCP client like Claude Desktop, you can configure it as follows. This example assumes you are running the server directly from its source code.

First, ensure you have Python installed and the necessary dependencies (see Development section).

Then, in your MCP client configuration (e.g., `claude-desktop-settings.json`):

{
  "mcpServers": {
    "uuid_v7_generator": {
      "command": "python",
      "args": ["/path/to/your/mcp-uuid-server/mcp_uuid_server/server.py"],
      // Optional: specify the working directory if needed
      // "cwd": "/path/to/your/mcp-uuid-server/"
    }
  }
}

Replace `/path/to/your/mcp-uuid-server/` with the actual path to where you have cloned or placed the server code.

If the server were packaged and published in a way that `uvx` could run it (like some official MCP servers), the configuration might look like this (this is a hypothetical example as this server is not currently published this way):

{
  "mcpServers": {
    "uuid_v7_generator": {
      "command": "uvx",
      "args": ["mcp-uuid-server"]
    }
  }
}

Running the Server Directly

You can run the server directly for development or local use:

python /path/to/your/mcp-uuid-server/mcp_uuid_server/server.py

The server will start and listen for MCP client connections on stdin/stdout.

Available Tools

1. `get_uuidv7`:

2. `get_uuidv7_batch`:

Development

To set up the development environment:

1. Clone the repository.

2. It's recommended to create and activate a virtual environment:

python -m venv .venv
    source .venv/bin/activate  # On Windows use .venv\Scripts\activate

3. Install the dependencies from `pyproject.toml` (which includes `mcp` and `uuid6`):

pip install .

For editable mode, which is useful during development as changes to the source code are immediately reflected without needing to reinstall:

pip install -e .

4. Run the server directly for testing:

python mcp_uuid_server/server.py

Troubleshooting

JSON Parse Error

If you encounter an error message similar to `MCP ERROR (uuid_v7_generator): SyntaxError: JSON Parse error: Unable to parse JSON string`, this typically indicates that the MCP client (e.g., Claude Desktop) sent a malformed JSON request to this server.

To resolve this:

• Verify Client Requests: Check the JSON requests being formulated and sent by your MCP client. Ensure they are syntactically correct JSON.
• Check Encoding: Ensure that the JSON requests are UTF-8 encoded, as this is the standard for JSON.
• Tool Arguments: