# rookery-mcp

A free, fully-offline **MCP (Model Context Protocol)** server that exposes
utility tools to any MCP client — Claude, Cursor, Cline, and other coding
agents. Written in Python, runs over **stdio**, **zero dependencies**, no
API keys, no tracking, works offline.

## Tools

| Tool | What it does |
|---|---|
| `base64_encode` | UTF-8-safe Base64 encode |
| `base64_decode` | Base64 decode back to text |
| `uuid_v4` | Generate 1–100 random UUID v4 |
| `json_validate` | Validate JSON, pretty-print or minify |
| `sha_hash` | SHA-256/384/512 hash of text |
| `timestamp_to_iso` | Unix seconds/ms → ISO-8601 UTC |
| `url_encode` | Percent-encode / decode |
| `case_convert` | snake / kebab / camel / pascal / upper / lower |
| `password_generate` | Cryptographically secure random password |

All tools are exposed via the standard MCP methods: `tools/list` and
`tools/call` (JSON-RPC 2.0 over stdio).

## Requirements

- Python 3.9+

## Run

```bash
python server.py
```

Install as a Python package:

```bash
uvx --from git+https://github.com/vikash-b5/rookery-mcp -- rookery-mcp
```

## Add to an MCP client

Register `python /path/to/server.py` (or `rookery-mcp`) as a stdio MCP
server in your client's config (e.g. Claude Desktop, Cursor, Cline).

## Docker

A `Dockerfile` is included for containerized / registry introspection:

```dockerfile
FROM python:3.11-slim
WORKDIR /app
COPY pyproject.toml server.py README.md ./
CMD ["python", "-u", "server.py"]
```

## Test

```bash
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | python server.py
python server.py --list-tools
```

The server starts instantly and answers `initialize` + `tools/list`
requests, so it passes MCP registry checks (Glama, mcp.so, official
registry).

## License

MIT