justpen-utility-mcp

Generate TOTP codes, decode a single QR code from a local image and render Burp-style evidence screenshots through MCP. The server is named justpen-utility and supports stdio and Streamable HTTP.

After make setup, start the server from the repository root:

uv run python -m justpen_utility_mcp

Stdio is the default. HTTP listens on 127.0.0.1:8933 and serves /mcp when selected. Logs go to stderr; stdio stdout carries only the MCP protocol.

• API reference: tool arguments, response envelopes and Python modules.
• Server configuration: transport, listener and logging settings.
• Telemetry: opt-in OTLP traces, events, metrics and privacy boundaries.
• Getting started: development installation and commands.
• Claude Code and Codex: shared policy and the protected-files guard.
• PR checklist: required verification and merge rules.
• Lint and typing: formatters, strict types and coverage.
• Release process: changelogs and release validation.
• Template updates: maintain the recorded development baseline while preserving the application.