Sign inSign up

aeciopires/mytoolkit

By aeciopires

β€’Updated 2 days ago

A web application for formatting, encoding, decoding, hashing, and generating data

Image
1

1.7K

aeciopires/mytoolkit repository overview

⁠MyToolkit

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.

Source code License: GPL v3 Platforms

⁠Table of Contents

⁠What is MyToolkit?

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:

SurfaceCommandUse it for
πŸ–₯️ Web UIserve (default)A responsive Material 3 interface with light/dark theme, navigation drawer, and live tool search
πŸ”Œ REST APIserveScripts and integrations, documented with Swagger/OpenAPI at /swagger/index.html
⌨️ CLI<tool-slug>One-off commands and shell pipelines over stdin/stdout
πŸ€– MCP servermcpExposing every tool to AI assistants such as Claude Desktop and Claude Code (stdio or HTTP)

Everything runs fully offline inside your own infrastructure.

⁠Features

ToolDescription
🌳JSON Tree ViewerVisualize JSON structures as a tree for easier navigation and analysis.
πŸ“„JSON FormatterPretty-print or minify JSON documents.
πŸ“YAML FormatterFormat YAML files with consistent indentation.
πŸ”Password GeneratorGenerate strong, customizable passwords, with the option to exclude confusing or ambiguous characters.
🎫JWT Encode/DecodeDecode 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 GeneratorGenerate QR codes (PNG) from text, URLs, or Unicode content.
πŸ“ŠCharacter, Word & Line CounterCount characters, words, and lines in any text.
🌐URL Encode/DecodeEncode and decode URLs according to web standards.
πŸ”’Hash GeneratorGenerate MD5, SHA-1, SHA-256, and SHA-512 hashes.
πŸ”€Base64 Encode/DecodeEncode and decode Base64 (standard or URL-safe).
πŸ”‘Case ConverterConvert between Sentence case, UPPER CASE, lower case, Title Case, MiXeD CaSe, and iNvErSe cAsE.
πŸͺΆJSON to TOON ConverterConvert JSON into TOON⁠ to reduce LLM token usage. The web page converts entirely in your browser.
πŸ”ƒYAML to JSON ConverterConvert YAML to pretty-printed JSON.
πŸ”„JSON to YAML ConverterConvert JSON to YAML.
☸️Kubernetes YAML ValidatorCheck that single or multi-document YAML has the fields the Kubernetes API requires (apiVersion, kind, and a well-formed metadata block).

Production features:

  • πŸ“ˆ Prometheus metrics at /metrics (OpenMetrics, with trace_id exemplars), including a tool usage ranking.
  • πŸ”­ OpenTelemetry tracing (OTLP/HTTP), turned on by setting the standard OTEL_* environment variables.
  • 🧾 Structured JSON logs on stderr, ready for Loki or any other log pipeline.
  • ❀️ Health checks: /healthz (liveness) and /readyz (readiness, returns 503 during graceful shutdown).
  • ☸️ Helm chart for Kubernetes, available in the source repository.

⁠Quick start

⁠Pull the latest image
docker pull aeciopires/mytoolkit:latest

The image is multi-arch: linux/amd64 and linux/arm64. Docker picks the right one for your host.

⁠Run the web UI and REST API
docker run -d --name mytoolkit -p 8080:8080 aeciopires/mytoolkit:latest

Then open:

⁠Use the REST API

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.

⁠Use the CLI

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.

⁠Run the MCP server

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
⁠Docker Compose
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.

⁠Configuration

VariableDefaultDescription
MYTOOLKIT_HOST0.0.0.0Interface the server binds to.
MYTOOLKIT_PORT8080Port for the web UI and REST API.
MYTOOLKIT_LOG_LEVELinfodebug, info, warn, or error. Logs are always JSON on stderr.
MYTOOLKIT_MCP_TRANSPORTstdioMCP transport: stdio or http.
MYTOOLKIT_MCP_PORT8081Port for mcp --transport http.
MYTOOLKIT_SHUTDOWN_DELAY0Time to keep serving (with /readyz returning 503) after SIGTERM, for example 5s.
OTEL_EXPORTER_OTLP_ENDPOINTunsetSetting 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.

⁠Ports and endpoints

PortProcessEndpoints
8080serve (default)/ (web UI), /api/v1/tools/<slug>, /api/v1/tools, /api/v1/metrics/ranking, /swagger/index.html, /metrics, /healthz, /readyz
8081mcp --transport httpMCP endpoint, /metrics, /healthz, /readyz

⁠Image details

  • Base image: gcr.io/distroless/static-debian13:nonroot. It has no shell or package manager, which keeps the attack surface small.
  • User: runs as nonroot, never as root.
  • Binary: statically linked Go binary (CGO_ENABLED=0, stripped) at /mytoolkit.
  • Entrypoint / command: ENTRYPOINT ["/mytoolkit"], CMD ["serve"].
  • Tags: latest and semantic versions (for example 1.2.0). Pin a version tag in production.

⁠Source code and documentation

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⁠

Issues, stars ⭐, and contributions are welcome!

⁠License

GNU General Public License v3.0⁠

Developed by Aecio dos Santos Pires: LinkedIn⁠ · Website⁠

Tag summary

Content type

Image

Digest

sha256:428202367…

Size

12 MB

Last updated

2 days ago

docker pull aeciopires/mytoolkit