时间戳UUID生成器

@tanker327/uuid-mcp
0 Stars 151 次浏览 tanker327 更新于 2026-08-23

一个简单的模型上下文协议服务器,当被LLM调用时生成基于时间戳的UUID(v7),提供无需输入参数的按时间顺序可排序的唯一标识符。

该服务暂未提供标准配置,请参考 README 手动接入

服务介绍

UUID MCP 提供者

一个简单的模型上下文协议 (MCP) 服务器,每当被 LLM 调用时,它都会提供基于时间戳的 UUID。

特性

  • 提供单个工具:generateUuid
  • 使用 UUID v7 生成基于时间戳的唯一标识符
  • 简单的接口,不需要输入参数
  • 易于与 Claude 和其他 LLM 集成

安装

# Install dependencies
npm install

# Build the project
npm run build

使用

你可以直接运行服务器:

npm start

与 Claude Desktop 的集成

要与 Claude Desktop 集成,请将以下内容添加到你的 Claude Desktop 配置文件中:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "uuid-provider": {
      "command": "node",
      "args": ["/absolute/path/to/uuid-mcp/build/index.js"]
    }
  }
}

/absolute/path/to/uuid-mcp/build/index.js 替换为你的构建后的 index.js 文件的绝对路径。

更新配置后,重启 Claude Desktop 即可看到 UUID 生成工具可用。

工作原理

该服务器使用官方的 uuid 包来生成 UUID v7 标识符。UUID v7 特别设计为基于时间戳,同时保持强唯一性保证:

  • 包含毫秒精度的 Unix 时间戳
  • 添加随机数据以确保即使在同一毫秒内生成多个 ID 也能保持唯一性
  • 遵循最新的 RFC 标准进行 UUID 生成
  • 提供按时间顺序可排序的标识符
  • 防止分布式系统中的冲突

这种方法比自定义 UUID 实现更可靠,并且即使在高负载下也能消除重复的可能性。

依赖项

  • @modelcontextprotocol/sdk: 用于 MCP 服务器实现
  • uuid: 用于符合 RFC 的 UUID 生成
  • TypeScript 及相关开发工具

示例

当调用此工具时,它会返回一个如下所示的 UUID v7 字符串:

018e94d2-279b-7bd3-9289-80d1e6619670

UUID 的第一部分包含时间戳,这使得这些标识符按时间顺序可排序,同时仍保持标准 UUID 格式。