Mcp Uuidv7 Generator

Name: Mcp Uuidv7 Generator
Author: pomazanbohdan

本地服务

github.com/pomazanbohdan开发工具063 周前更新

代码仓库

关于 Mcp Uuidv7 Generator

Mcp Uuidv7 Generator 是一个供 MCP 客户端调用的 UUIDv7 生成服务，适用于需要单个或批量生成 UUIDv7 的场景。它提供两个专用工具。

主要功能

01生成单个 UUIDv7
02按数量批量生成 UUIDv7

适用场景

01为记录生成唯一标识符
02一次生成多个 UUIDv7

MCP 相关

作为 MCP 服务，它向 MCP 客户端提供生成单个 UUIDv7 和按指定数量生成 UUIDv7 的工具。

#uuid-generator #mcp #uuidv7

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令uvx mcp-uuid-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypimcp-uuid-serverstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-uuidv7-generator

用于生成 UUIDv7 字符串的模型上下文协议（MCP）服务。

使用 trae.ai 通过 vibe-coding 创建

功能

获取单个 UUIDv7 字符串。
批量获取 UUIDv7 字符串。

用法

要将此服务与 Claude Desktop 等 MCP 客户端配合使用，可以按如下方式进行配置。此示例假设你直接从源代码运行服务。

首先，确保已安装 Python 和所需依赖项（请参阅“开发”部分）。

然后，在 MCP 客户端配置文件中（例如，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/"
    }
  }
}

将 /path/to/your/mcp-uuid-server/ 替换为你克隆或放置服务代码的实际路径。

如果此服务已打包并以 uvx 可运行的方式发布（类似一些官方 MCP 服务），配置可能如下所示（这是一个假设性示例，因为此服务目前尚未以这种方式发布）：

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

直接运行服务

你可以直接运行服务以进行开发或本地使用：

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

服务将启动，并通过 stdin/stdout 监听 MCP 客户端连接。

可用工具

get_uuidv7：
- 描述：生成并返回单个 UUIDv7 字符串。
- 参数：无
- 返回：表示 UUIDv7 的字符串。
get_uuidv7_batch：
- 描述：生成并返回 UUIDv7 字符串列表。
- 参数：
  - count（整数）：要生成的 UUIDv7 字符串数量。必须为正整数。
- 返回：字符串列表，其中每个字符串都是一个 UUIDv7。

开发

设置开发环境：

克隆仓库。

建议创建并激活虚拟环境：

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

从 pyproject.toml 安装依赖项（其中包括 mcp 和 uuid6）：
```
pip install .
```
如需使用可编辑模式（便于开发，因为源代码的更改会立即生效，无需重新安装）：
```
pip install -e .
```
直接运行服务进行测试：
```
python mcp_uuid_server/server.py
```

故障排除

JSON 解析错误

如果遇到类似 MCP ERROR (uuid_v7_generator): SyntaxError: JSON Parse error: Unable to parse JSON string 的错误消息，通常表示 MCP 客户端（例如 Claude Desktop）向此服务发送了格式错误的 JSON 请求。

解决方法：

验证客户端请求：检查 MCP 客户端构造并发送的 JSON 请求。确保其符合 JSON 语法。
检查编码：确保 JSON 请求使用 UTF-8 编码，这是 JSON 的标准编码。
工具参数：
- 对于 get_uuidv7，客户端应发送注明工具名称的请求，通常不带参数或使用空参数对象。
- 对于 get_uuidv7_batch，客户端必须以 JSON 对象形式发送参数，并包含整数类型的 count 字段，例如：{"count": 10}。将 count 作为字符串发送（例如 {"count": "10"}）或请求结构存在其他格式错误，都可能导致解析问题。