Makefile

PYTHON ?= python3
UV ?= uv
VENV_DIR ?= .venv
DOCKER_COMPOSE ?= docker compose

.PHONY: help venv install run run-venv format format-check check clean docker-up docker-down docker-logs
.PHONY: bootstrap-uv ensure-uv

help:
	@echo "Targets:"
	@echo "  make bootstrap-uv - install uv in user site-packages"
	@echo "  make venv         - create virtual environment with uv"
	@echo "  make install      - install runtime + dev dependencies with uv"
	@echo "  make run          - run MCP server with uv"
	@echo "  make run-venv     - alias for make run"
	@echo "  make format       - format Python files using Black"
	@echo "  make format-check - check Black formatting"
	@echo "  make check        - compile check + Black check"
	@echo "  make docker-up   - start server with docker compose"
	@echo "  make docker-down - stop docker compose service"
	@echo "  make docker-logs - tail docker compose logs"
	@echo "  make clean       - remove local virtual environment"


bootstrap-uv:
	sh -c "curl -LsSf https://astral.sh/uv/install.sh | sh"

ensure-uv:
	@command -v $(UV) >/dev/null 2>&1 || \
		(echo "uv is not installed or not on PATH. Run 'make bootstrap-uv' and add ~/.local/bin to PATH." && exit 1)

venv: ensure-uv
	$(UV) venv $(VENV_DIR)

install: ensure-uv venv
	$(UV) sync --dev

run: ensure-uv
	$(UV) run -m src.server

run-venv: run

format: ensure-uv
	$(UV) run black src

format-check: ensure-uv
	$(UV) run black --check src

check: ensure-uv
	$(UV) run python -m py_compile src/server.py src/__init__.py
	$(MAKE) format-check

docker-up:
	$(DOCKER_COMPOSE) up --build -d

docker-down:
	$(DOCKER_COMPOSE) down

docker-logs:
	$(DOCKER_COMPOSE) logs -f mcp-server

clean:
	rm -rf $(VENV_DIR)