Uuid Provider

UUID MCP プロバイダー

LLM から呼び出されるたびに、タイムスタンプベースの UUID を提供するシンプルな Model Context Protocol（MCP）サーバーです。

特長

• 単一のツール 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 が生成されても一意性が保たれるよう、ランダム化されたデータを追加します
• UUID 生成に関する最新の RFC 標準に準拠しています
• 時系列順に並べ替え可能な識別子を提供します
• 分散システムでの衝突を防ぎます

この方法はカスタム UUID 実装よりも信頼性が高く、高負荷時でも重複が発生する可能性を排除します。

依存関係

• @modelcontextprotocol/sdk：MCP サーバーの実装に使用
• uuid：RFC に準拠した UUID 生成に使用
• 開発用の TypeScript および関連ツール

例

呼び出すと、ツールは次のような UUID v7 文字列を返します。

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

UUID の先頭部分にはタイムスタンプが含まれているため、標準の UUID 形式を保ちながら、識別子を時系列順に並べ替えられます。