Uuid Generator Actor MCP

带MCP服务器的UUID生成器执行器

用于Apify平台的全面UUID工具包，具有模型上下文协议（MCP）服务器集成功能。生成、验证、分析和管理通用唯一标识符（UUID），支持多个UUID版本和高级操作。

特性

核心业务

1. 生成 -批量创建支持多版本的UUID
2. 验证 -检查UUID是否有效并标识其版本
3. 分析 -从UUID中提取详细信息（版本、变体、时间戳、格式）
4. 转换 -在不同格式之间转换UUID
5. 批量验证 -一次验证多个UUID
6. 批量分析 -使用统计信息分析多个UUID
7. 检查碰撞 -在集合中查找重复的UUID
8. 统计 -生成全面的UUID统计信息

UUID版本支持

• 版本1（v1）：带有MAC地址的基于时间戳的UUID
• 版本4（v4）：随机UUID（最常见）
• 版本5（v5）：使用SHA-1的基于命名空间的UUID

输出格式

• JSON：具有完整元数据支持的结构化数据
• CSV：数据库导入的逗号分隔值
• 纯文本：每行一个UUID，便于简单集成

MCP服务器集成

内置模型上下文协议服务器，用于AI代理集成。允许AI助手（如Claude、GPT等）作为工具直接访问UUID操作。

快速开始

作为一名Apify演员

const { ApifyClient } = require('apify-client');

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('YOUR_ACTOR_ID').call({
    operation: 'generate',
    uuidVersion: 'v4',
    count: 100,
    outputFormat: 'json',
});

作为MCP服务器

在MCP设置中配置：

{
  "mcpServers": {
    "uuid-generator": {
      "command": "npx",
      "args": ["-y", "uuid-generator-actor", "mcp"]
    }
  }
}

运营

1.生成UUID

使用指定的版本和格式选项批量创建UUID。

输入：

{
  "operation": "generate",
  "uuidVersion": "v4",
  "count": 10,
  "outputFormat": "json",
  "includeMetadata": true,
  "uppercase": false,
  "removeDashes": false
}

输出：

[
  {
    "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "version": "v4",
    "timestamp": "2025-11-06T10:30:00.000Z",
    "format": "standard"
  }
]

2.验证UUID

检查UUID是否有效并获取其版本。

输入：

{
  "operation": "validate",
  "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "outputFormat": "json"
}

输出：

{
  "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "valid": true,
  "version": 4,
  "message": "Valid UUID version 4"
}

3.分析UUID

提取详细信息，包括版本、变体、格式和时间戳（适用于v1）。

输入：

{
  "operation": "analyze",
  "uuid": "6fa459ea-ee8a-11ed-a05b-0242ac120003",
  "outputFormat": "json"
}

输出：

{
  "valid": true,
  "uuid": "6fa459ea-ee8a-11ed-a05b-0242ac120003",
  "version": 1,
  "format": "standard",
  "variant": "RFC 4122",
  "type": "timestamp-based",
  "timestamp": {
    "iso": "2023-04-20T15:30:42.000Z",
    "unix": 1682005842000,
    "raw": "138967806420000000"
  }
}

4.转换格式

在不同格式（标准/紧凑、大小写）之间转换UUID。

输入：

{
  "operation": "convert",
  "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "uppercase": true,
  "removeDashes": true,
  "outputFormat": "json"
}

输出：

{
  "original": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "converted": "F47AC10B58CC4372A5670E02B2C3D479",
  "options": {
    "uppercase": true,
    "removeDashes": true
  }
}

5.批量验证

一次验证多个UUID。

输入：

{
  "operation": "batch_validate",
  "uuids": [
    "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "invalid-uuid",
    "8b3e8f7a-5d9c-4b2a-9f1e-6d8c7b5a4e3d"
  ],
  "outputFormat": "json"
}

输出：

{
  "total": 3,
  "valid": 2,
  "invalid": 1,
  "results": [
    {
      "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "valid": true,
      "version": 4
    },
    {
      "uuid": "invalid-uuid",
      "valid": false,
      "version": null
    },
    {
      "uuid": "8b3e8f7a-5d9c-4b2a-9f1e-6d8c7b5a4e3d",
      "valid": true,
      "version": 4
    }
  ]
}

6.批量分析

使用版本细分分析多个UUID。

输入：

{
  "operation": "batch_analyze",
  "uuids": [
    "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "6fa459ea-ee8a-11ed-a05b-0242ac120003"
  ],
  "outputFormat": "json"
}

输出：

{
  "total": 2,
  "valid": 2,
  "invalid": 0,
  "versionBreakdown": {
    "1": 1,
    "4": 1
  },
  "results": [...]
}

7.检查碰撞

在集合中查找重复的UUID。

输入：

{
  "operation": "check_collisions",
  "uuids": [
    "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "8b3e8f7a-5d9c-4b2a-9f1e-6d8c7b5a4e3d",
    "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  ],
  "outputFormat": "json"
}

输出：

{
  "total": 3,
  "unique": 2,
  "duplicates": 1,
  "collisions": [
    {
      "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "index": 2
    }
  ]
}

8.生成统计数据

获取有关UUID集合的全面统计信息。

输入：

{
  "operation": "statistics",
  "uuids": [
    "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "6fa459ea-ee8a-11ed-a05b-0242ac120003",
    "cfbff0d1-9375-5685-968c-48ce8b15ae17"
  ],
  "outputFormat": "json"
}

输出：

{
  "total": 3,
  "versions": {
    "1": 1,
    "4": 1,
    "5": 1
  },
  "formats": {
    "standard": 3,
    "compact": 0
  },
  "variants": {
    "RFC 4122": 3
  }
}

MCP服务器工具

当作为MCP服务器运行时，AI代理可以使用以下工具：

• generate_uuid -生成具有版本和格式选项的UUID
• validate_uuid -验证单个UUID
• analyze_uuid -分析UUID并提取详细信息
• convert_uuid_format -转换UUID格式
• batch_validate -验证多个UUID
• batch_analyze -分析多个UUID
• check_collisions -查找重复项
• generate_statistics -生成UUID统计信息

MCP服务器使用情况

启动MCP服务器：

npm run mcp

或者全局安装并运行：

npm install -g uuid-generator-actor
uuid-generator-mcp

配置

输入架构

预定义命名空间（UUID v5）

• DNS -域名（6ba7b810-9dad-11d1-80b4-00c04fd430c8）
• URL -用于URL（6ba7b811-9dad-11d1-80b4-00c04fd430c8）
• OID -用于ISO OID（6ba7b812-9dad-11d1-80b4-00c04fd430c8）
• X500 -适用于X.500 DN（6ba7b814-9dad-11d1-80b4-00c04fd430c8）

用例

软件开发

• 为数据库记录生成唯一ID
• 创建会话令牌
• 生成唯一的文件名
• API密钥生成

测试与质量保证

• 生成具有唯一标识符的测试数据
• 验证API中的UUID字段
• 测试UUID抗碰撞性
• 使用批量UUID生成进行性能测试

数据管理

• 数据库记录标识
• 分布式系统节点ID
• 文件版本控制系统
• 消息队列标识符

分析与审计

• 验证数据集中的UUID合规性
• 分析UUID版本分布
• 检测重复标识符
• 生成UUID使用情况报告

API集成

使用Apify客户端

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

// Generate UUIDs
const generateRun = await client.actor('YOUR_ACTOR_ID').call({
  operation: 'generate',
  uuidVersion: 'v4',
  count: 1000,
  outputFormat: 'json'
});

const dataset = await client.dataset(generateRun.defaultDatasetId).listItems();
console.log(dataset.items);

使用Apify SDK

import { Actor } from 'apify';

// Call the UUID Generator Actor
const run = await Actor.call('YOUR_ACTOR_ID', {
  operation: 'validate',
  uuid: 'f47ac10b-58cc-4372-a567-0e02b2c3d479'
});

// Get results
const { items } = await Actor.openDataset(run.defaultDatasetId).getData();
console.log(items[0]);

演出

• 生成：每次运行最多100000个UUID
• 验证：高效处理大批量
• 记忆：针对最小内存占用进行了优化
• 进度记录：批量>1000个项目的实时更新

最佳实践

1. 将UUID v4用于一般用途 -随机UUID适用于大多数用例
2. 使用UUID v5进行确定性生成 -当您需要相同的输入来生成相同的UUID时
3. 使用UUID v1作为可排序标识符 -当时间顺序很重要时
4. 批量操作提高效率 -在一次运行中处理多个UUID
5. 选择合适的输出格式:

- JSON用于元数据和结构化数据 - CSV用于数据库导入 - 用于简单脚本和管道的文本

RFC 4122合规性

此Actor遵循RFC 4122标准：

• 所有生成的UUID中的正确版本位
• 正确的变量字段编码
• 标准格式（8-4-4-4-12十六进制数字）
• v4的加密安全随机生成

错误处理

Actor包括全面的错误处理：

• 带有明确错误消息的输入验证
• UUID格式验证
• 版本特定要求检查
• 巧妙处理无效输入

安装

本地安装

git clone https://github.com/Yash-Kavaiya/uuid-generator-actor-mcp.git
cd uuid-generator-actor-mcp
npm install

本地运行

# As Apify Actor
npm start

# As MCP Server
npm run mcp

例子

看 .actor/input_examples/ 目录，用于所有操作的完整示例配置。

支持与贡献

• 报告问题:
• 贡献：欢迎拉取请求
• 文档: API完整文档

许可证

阿帕奇-2.0

关键词

uuid、guid、标识符、生成器、apify、actor、mcp、模型上下文协议、验证、分析、批处理操作、唯一id、v1、v4、v5、随机、时间戳、命名空间、冲突检测

______________________________________________________________________

生产就绪 -此Actor遵循Apify最佳实践，专为可靠性、可扩展性以及与现有工作流和AI代理的轻松集成而设计。