Metadata-Version: 2.4
Name: alevlas-random-mcp
Version: 0.1.1
Summary: Minimal MCP server that generates random integers, strings, and UUIDs.
Author: alevlas
License: MIT
Keywords: kiro,mcp,random
Requires-Python: >=3.11
Requires-Dist: mcp>=1.2.0
Description-Content-Type: text/markdown

# 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)

```bash
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`:

```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):

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

Verify the published package runs from CodeArtifact:

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