A web application for formatting, encoding, decoding, hashing, and generating data
1.7K
15 everyday developer utilities in one small, secure container. Run them from a web UI, a REST API, a CLI, or an MCP server for AI assistants.
MyToolkit puts the small conversions and generators developers, analysts, and IT professionals reach for every day (formatting JSON, decoding a JWT, hashing a string, generating a password) into one place. You don't need to jump between websites or paste sensitive data into third-party services.
A single Go binary offers four ways to use the tools. All four call the same implementation:
| Surface | Command | Use it for |
|---|---|---|
| π₯οΈ Web UI | serve (default) | A responsive Material 3 interface with light/dark theme, navigation drawer, and live tool search |
| π REST API | serve | Scripts and integrations, documented with Swagger/OpenAPI at /swagger/index.html |
| β¨οΈ CLI | <tool-slug> | One-off commands and shell pipelines over stdin/stdout |
| π€ MCP server | mcp | Exposing every tool to AI assistants such as Claude Desktop and Claude Code (stdio or HTTP) |
Everything runs fully offline inside your own infrastructure.
| Tool | Description | |
|---|---|---|
| π³ | JSON Tree Viewer | Visualize JSON structures as a tree for easier navigation and analysis. |
| π | JSON Formatter | Pretty-print or minify JSON documents. |
| π | YAML Formatter | Format YAML files with consistent indentation. |
| π | Password Generator | Generate strong, customizable passwords, with the option to exclude confusing or ambiguous characters. |
| π« | JWT Encode/Decode | Decode and verify tokens (secret, PEM, JWK, or JWKS), sign tokens with registered and custom claims, generate HMAC/RSA/EC/Ed25519 keys, and build JWKS documents. |
| π± | QR Code Generator | Generate QR codes (PNG) from text, URLs, or Unicode content. |
| π | Character, Word & Line Counter | Count characters, words, and lines in any text. |
| π | URL Encode/Decode | Encode and decode URLs according to web standards. |
| π | Hash Generator | Generate MD5, SHA-1, SHA-256, and SHA-512 hashes. |
| π€ | Base64 Encode/Decode | Encode and decode Base64 (standard or URL-safe). |
| π‘ | Case Converter | Convert between Sentence case, UPPER CASE, lower case, Title Case, MiXeD CaSe, and iNvErSe cAsE. |
| πͺΆ | JSON to TOON Converter | Convert JSON into TOONβ to reduce LLM token usage. The web page converts entirely in your browser. |
| π | YAML to JSON Converter | Convert YAML to pretty-printed JSON. |
| π | JSON to YAML Converter | Convert JSON to YAML. |
| βΈοΈ | Kubernetes YAML Validator | Check that single or multi-document YAML has the fields the Kubernetes API requires (apiVersion, kind, and a well-formed metadata block). |
Production features:
/metrics (OpenMetrics, with trace_id exemplars), including a tool usage ranking.OTEL_* environment variables./healthz (liveness) and /readyz (readiness, returns 503 during graceful shutdown).docker pull aeciopires/mytoolkit:latest
The image is multi-arch: linux/amd64 and linux/arm64. Docker picks the right one for your host.
docker run -d --name mytoolkit -p 8080:8080 aeciopires/mytoolkit:latest
Then open:
Every tool is available at POST /api/v1/tools/<slug>:
curl -s -X POST http://localhost:8080/api/v1/tools/hash-gen \
-H 'Content-Type: application/json' \
-d '{"input":"hello","options":{"algorithm":"sha256"}}'
{"success":true,"data":{"output":"2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"},"meta":{"tool":"hash-gen","duration_ms":0.212}}
To list every available tool, call GET /api/v1/tools.
Override the default command with any tool slug. Input is read from stdin and output goes to stdout:
# Hash a string
echo -n 'hello' | docker run --rm -i aeciopires/mytoolkit:latest hash-gen --algo sha256
# Base64-encode
echo -n 'hello' | docker run --rm -i aeciopires/mytoolkit:latest base64
# Convert JSON to YAML
echo '{"a":1,"b":[1,2]}' | docker run --rm -i aeciopires/mytoolkit:latest json-to-yaml
# Generate a 24-character password with symbols
docker run --rm aeciopires/mytoolkit:latest password-gen --length 24 --symbols
# Show all commands and the version
docker run --rm aeciopires/mytoolkit:latest --help
docker run --rm aeciopires/mytoolkit:latest --version
To see the flags for a specific tool, run docker run --rm aeciopires/mytoolkit:latest <tool-slug> --help.
The MCP server exposes 18 tools: the 15 above, with JWT split into jwt_decode, jwt_encode, jwt_keygen, and jwt_jwks.
stdio transport (for local MCP clients). The -i flag is required:
docker run --rm -i aeciopires/mytoolkit:latest mcp
Example client configuration (Claude Desktop / Claude Code):
{
"mcpServers": {
"mytoolkit": {
"command": "docker",
"args": ["run", "--rm", "-i", "aeciopires/mytoolkit:latest", "mcp"]
}
}
}
HTTP transport (Streamable HTTP, for a shared or remote endpoint):
docker run -d --name mytoolkit-mcp -p 8081:8081 \
aeciopires/mytoolkit:latest mcp --transport http
services:
mytoolkit:
image: aeciopires/mytoolkit:latest
ports:
- "8080:8080"
environment:
MYTOOLKIT_LOG_LEVEL: info
healthcheck:
test: ["CMD", "/mytoolkit", "healthcheck"]
interval: 15s
timeout: 3s
retries: 3
restart: unless-stopped
The image is distroless, so it has no shell and no curl. Use the built-in mytoolkit healthcheck subcommand for container health checks. Add --path /readyz to check readiness, or --mcp to check the MCP port.
| Variable | Default | Description |
|---|---|---|
MYTOOLKIT_HOST | 0.0.0.0 | Interface the server binds to. |
MYTOOLKIT_PORT | 8080 | Port for the web UI and REST API. |
MYTOOLKIT_LOG_LEVEL | info | debug, info, warn, or error. Logs are always JSON on stderr. |
MYTOOLKIT_MCP_TRANSPORT | stdio | MCP transport: stdio or http. |
MYTOOLKIT_MCP_PORT | 8081 | Port for mcp --transport http. |
MYTOOLKIT_SHUTDOWN_DELAY | 0 | Time to keep serving (with /readyz returning 503) after SIGTERM, for example 5s. |
OTEL_EXPORTER_OTLP_ENDPOINT | unset | Setting it to an OTLP/HTTP endpoint enables tracing. The other standard OTEL_* variables also apply. |
Command-line flags (for example serve --port 9090) take precedence over environment variables.
| Port | Process | Endpoints |
|---|---|---|
8080 | serve (default) | / (web UI), /api/v1/tools/<slug>, /api/v1/tools, /api/v1/metrics/ranking, /swagger/index.html, /metrics, /healthz, /readyz |
8081 | mcp --transport http | MCP endpoint, /metrics, /healthz, /readyz |
gcr.io/distroless/static-debian13:nonroot. It has no shell or package manager, which keeps the attack surface small.nonroot, never as root.CGO_ENABLED=0, stripped) at /mytoolkit.ENTRYPOINT ["/mytoolkit"], CMD ["serve"].latest and semantic versions (for example 1.2.0). Pin a version tag in production.The source code, Dockerfile, Helm chart, observability stack (Prometheus, Grafana, Loki, Tempo, Jaeger, Alloy), and full per-tool documentation are on GitHub:
π https://github.com/aeciopires/mytoolkitβ
docs/api/β docs/cli/β mcp/README.mdβ helm/mytoolkitβ Issues, stars β, and contributions are welcome!
GNU General Public License v3.0β
Developed by Aecio dos Santos Pires: LinkedInβ Β· Websiteβ
Content type
Image
Digest
sha256:428202367β¦
Size
12 MB
Last updated
2 days ago
docker pull aeciopires/mytoolkit