Mcp Uuidv7 Generator

mcp-uuidv7-generator

UUIDv7 文字列を生成するための Model Context Protocol（MCP）サーバーです。

trae.ai を使用したバイブコーディングで作成

機能

• UUIDv7 文字列を 1 つ取得します。
• UUIDv7 文字列をまとめて取得します。

使用方法

このサーバーを Claude Desktop などの MCP クライアントで使用するには、次のように設定します。この例では、サーバーをソースコードから直接実行することを前提としています。

まず、Python がインストールされていること、および必要な依存関係があることを確認してください（「開発」セクションを参照）。

次に、MCP クライアントの設定（例：claude-desktop-settings.json）に以下を追加します。

{
  "mcpServers": {
    "uuid_v7_generator": {
      "command": "python",
      "args": ["/path/to/your/mcp-uuid-server/mcp_uuid_server/server.py"],
      // Optional: specify the working directory if needed
      // "cwd": "/path/to/your/mcp-uuid-server/"
    }
  }
}

/path/to/your/mcp-uuid-server/ を、サーバーのコードをクローンまたは配置した実際のパスに置き換えてください。

このサーバーが、（一部の公式 MCP サーバーのように）uvx で実行できる形でパッケージ化および公開されている場合、設定は次のようになります（このサーバーは現在この形では公開されていないため、以下は仮の例です）。

{
  "mcpServers": {
    "uuid_v7_generator": {
      "command": "uvx",
      "args": ["mcp-uuid-server"]
    }
  }
}

サーバーを直接実行する

開発またはローカルでの使用のために、サーバーを直接実行できます。

python /path/to/your/mcp-uuid-server/mcp_uuid_server/server.py

サーバーが起動し、stdin/stdout で MCP クライアントからの接続を待ち受けます。

利用可能なツール

1. get_uuidv7：

   • 説明：UUIDv7 文字列を 1 つ生成して返します。
   • 引数：なし
   • 戻り値：UUIDv7 を表す文字列。

2. get_uuidv7_batch：

   • 説明：UUIDv7 文字列のリストを生成して返します。
   • 引数：
     • count（整数）：生成する UUIDv7 文字列の数です。正の整数である必要があります。
   • 戻り値：UUIDv7 を表す文字列のリスト。

開発

開発環境をセットアップするには、次の手順に従ってください。

1. リポジトリをクローンします。

2. 仮想環境を作成して有効化することをおすすめします。

   python -m venv .venv
   source .venv/bin/activate  # Windows の場合は .venv\Scripts\activate を使用
   

3. pyproject.toml（mcp と uuid6 を含む）から依存関係をインストールします。

   pip install .
   

   開発中にソースコードへの変更を再インストールなしですぐに反映できる編集可能モードの場合は、次のようにします。

   pip install -e .
   

4. テストのためにサーバーを直接実行します。

   python mcp_uuid_server/server.py
   

トラブルシューティング

JSON 解析エラー

MCP ERROR (uuid_v7_generator): SyntaxError: JSON Parse error: Unable to parse JSON string のようなエラーメッセージが表示される場合、通常は MCP クライアント（例：Claude Desktop）が不正な JSON リクエストをこのサーバーに送信したことを示しています。

解決するには、次の点を確認してください。

• クライアントのリクエストを確認：MCP クライアントが生成して送信している JSON リクエストを確認してください。構文的に正しい JSON であることを確かめてください。
• エンコーディングを確認：JSON リクエストが、JSON の標準である UTF-8 でエンコードされていることを確認してください。
• ツールの引数：
  • get_uuidv7 の場合、クライアントはツール名を示すリクエストを送信します。通常、パラメーターは不要ですが、空のパラメーターオブジェクトを指定することもできます。
  • get_uuidv7_batch の場合、クライアントは整数の count フィールドを含む JSON オブジェクトとしてパラメーターを送信する必要があります。例：{"count": 10}。count に文字列を指定する（例：{"count": "10"}）など、リクエスト構造に不備があると解析の問題につながる可能性があります。