UUID生成服务

一个基于Model Context Protocol (MCP)的服务器,提供时间戳基础的UUID生成功能,适用于LLM集成和分布式系统。

  • by tanker327
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 tanker327/uuid-mcp

使用说明

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
  • 窗户: %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,也能确保唯一性
  • 遵循UUID生成的最新RFC标准
  • 提供按时间顺序排序的标识符
  • 防止分布式系统中的冲突

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

依赖项

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

示例

调用时,该工具返回一个UUID v7字符串,如下所示:

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

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