alevlas-random-mcp

A minimal MCP server exposing three random-generation tools. Built for the Kiro enterprise MCP registry demo.

Tools

• generate_random_int(min_value, max_value) → one integer in [min, max]
• generate_random_string(length, alphabet="alphanumeric") → random string
• generate_uuid(version=4) → UUID4 (or UUID7 if version=7)

Run locally (for dev)

uv sync
export KB_MCP_LOG_LEVEL=DEBUG      # optional
uv run random-mcp --self-test      # prints one example of each tool

Try with Kiro directly (without the registry)

Drop this into ~/.kiro/settings/mcp.json or a workspace .kiro/mcp.json:

{
  "mcpServers": {
    "alevlas-random-local": {
      "command": "uv",
      "args": ["--project", "<absolute-path>/random-mcp", "run", "random-mcp"],
      "disabled": false,
      "autoApprove": ["generate_random_int", "generate_random_string", "generate_uuid"]
    }
  }
}

Reconnect from the Kiro MCP panel. Ask Kiro to "generate 5 random UUIDs."

Publish to CodeArtifact

Run from the repo root (after terraform apply has created the domain and repo):

pwsh -File ../scripts/publish-random-mcp.ps1

Verify the published package runs from CodeArtifact:

$env:UV_INDEX_URL = (pwsh -File ../scripts/get-index-url.ps1)
uvx alevlas-random-mcp --self-test