使用说明

项目简介

本项目 'uuid-mcp' 是一个实现了 Model Context Protocol (MCP) 的服务器，专注于为大型语言模型 (LLM) 客户端提供生成唯一 UUID (Universally Unique Identifier) 的功能。它通过 MCP 协议的标准接口，向客户端暴露一个名为 'generateUuid' 的工具，LLM 可以调用此工具来获取一个基于时间戳的 UUID v7 字符串。

主要功能点

提供 UUID v7 生成工具: 服务器核心功能是生成符合 RFC 标准的 UUID v7 版本，这种 UUID 包含时间戳信息，并保证全局唯一性。
基于 MCP 协议: 完全遵循 MCP 协议规范，易于与支持 MCP 协议的 LLM 客户端集成，例如 Claude Desktop。
简单易用: 工具无需任何输入参数，调用即返回 UUID 字符串，使用非常方便。
Stdio 传输: 使用标准输入输出 (Stdio) 作为默认传输协议，易于部署和集成。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。
下载仓库代码: 从 GitHub 仓库 https://github.com/tanker327/uuid-mcp 下载代码到本地。
安装依赖: 在仓库根目录下，打开终端并执行以下命令安装项目依赖：
```
npm install
```
构建项目: 执行以下命令构建项目，将 TypeScript 代码编译为 JavaScript 代码：
```
npm run build
```

服务器配置

要让 MCP 客户端（例如 Claude Desktop）连接到此 UUID 生成器 MCP 服务器，需要在客户端的配置文件中添加服务器配置信息。以 Claude Desktop 为例，你需要编辑其配置文件（macOS: '~/Library/Application Support/Claude/claude_desktop_config.json', Windows: '%APPDATA%\Claude\claude_desktop_config.json'），在 'mcpServers' 字段下添加如下配置：

{
  "mcpServers": {
    "uuid-provider": {  // 服务器名称，客户端用此名称引用
      "command": "node", // 启动服务器的命令，这里使用 node 运行 JavaScript
      "args": ["/absolute/path/to/uuid-mcp/build/index.js"] // 命令参数，指向构建后的服务器入口文件绝对路径
    }
  }
}

配置参数说明:

'"uuid-provider"': 这是你为该 MCP 服务器定义的名称，客户端会使用这个名称来识别和调用它。你可以自定义名称。
'"command": "node"': 指定运行服务器的命令是 'node'，假设你的环境中 'node' 命令可用。
'"args": ["/absolute/path/to/uuid-mcp/build/index.js"]': 请务必将 '/absolute/path/to/uuid-mcp/build/index.js' 替换为你本地 'uuid-mcp' 仓库 'build/index.js' 文件的绝对路径。 例如，如果你的仓库放在 'Users/yourname/uuid-mcp' 目录下，则路径可能类似于 '/Users/yourname/uuid-mcp/build/index.js'。

配置完成后，重启你的 MCP 客户端 (Claude Desktop) 使配置生效。

基本使用方法

配置并启动 MCP 服务器后，在支持 MCP 协议的 LLM 客户端中，你就可以调用 'generateUuid' 工具来生成 UUID 了。

以 Claude 为例，你可以在对话中指示 Claude 调用 'uuid-provider' 服务器的 'generateUuid' 工具，例如：

'请生成一个UUID'

Claude 可能会解析你的请求，并调用配置好的 'uuid-provider' 服务器的 'generateUuid' 工具，然后将生成的 UUID 返回给你。具体的调用方式取决于 LLM 客户端的实现，但通常会通过自然语言指令或特定的语法来触发工具调用。

注意: 本项目仅提供 UUID 生成工具，不包含资源管理或 Prompt 模板等 MCP 服务器的其他功能。

关键词