Feature/qr code server

mcp-servers/python/qr_code_server/Containerfile

@@ -0,0 +1,25 @@
+# syntax=docker/dockerfile:1
+FROM python:3.11-slim AS base
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PATH="/app/.venv/bin:$PATH"
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates curl && \
+    rm -rf /var/lib/apt/lists/*
+
+# Copy all source files before install (hatchling needs src/ at build time)
+COPY pyproject.toml README.md ./
+COPY src/ ./src/
+
+RUN python -m venv /app/.venv && \
+    /app/.venv/bin/pip install --upgrade pip setuptools wheel && \
+    /app/.venv/bin/pip install -e .
+
+RUN useradd -u 1001 -m appuser && chown -R 1001:1001 /app
+USER 1001
+
+CMD ["python", "-m", "qr_code_server.server"]

mcp-servers/python/qr_code_server/Makefile

@@ -0,0 +1,45 @@
+# Makefile for QR Code Server
+
+.PHONY: help install dev-install format lint test dev mcp-info serve-http test-http clean
+
+PYTHON ?= python3
+HTTP_PORT ?= 9000
+HTTP_HOST ?= localhost
+
+help: ## Show help
+	@awk 'BEGIN {FS=":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf "%-18s %s\n", $$1, $$2}' $(MAKEFILE_LIST)
+
+install: ## Install in editable mode
+	$(PYTHON) -m pip install -e .
+
+dev-install: ## Install with dev extras
+	$(PYTHON) -m pip install -e ".[dev]"
+
+format: ## Format (black + ruff --fix)
+	black . && ruff check --fix .
+
+lint: ## Lint (ruff, mypy)
+	ruff check . && mypy src/qr_code_server
+
+test: ## Run tests
+	pytest -v --cov=qr_code_server --cov-report=term-missing
+
+dev: ## Run stdio MCP server
+	@echo "Starting QR Code Server (stdio)..."
+	$(PYTHON) -m qr_code_server.server
+
+mcp-info: ## Show stdio client config snippet
+	@echo '{"command": "python", "args": ["-m", "qr_code_server.server"], "cwd": "'$(PWD)'"}'
+
+serve-http: ## Expose stdio server over HTTP (JSON-RPC + SSE)
+	@echo "HTTP: http://$(HTTP_HOST):$(HTTP_PORT)"
+	$(PYTHON) -m mcpgateway.translate --stdio "$(PYTHON) -m qr_code_server.server" --host $(HTTP_HOST) --port $(HTTP_PORT) --expose-sse
+
+test-http: ## Basic HTTP checks
+	curl -s http://$(HTTP_HOST):$(HTTP_PORT)/ | head -20 || true
+	curl -s -X POST -H 'Content-Type: application/json' \
+	  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' \
+	  http://$(HTTP_HOST):$(HTTP_PORT)/ | head -40 || true
+
+clean: ## Remove caches
+	rm -rf .pytest_cache .ruff_cache .mypy_cache __pycache__ */__pycache__