Contributing

Setup

git clone <repo-url>
cd sceptre-mcp-server
poetry install

Run tests directly with pytest:

poetry run pytest -q

Run tests through tox for a specific Python version:

# Use the virtualenv tox binary directly (poetry run intercepts flags like -e)
$(poetry env info -p)/bin/tox -e py312

Run against all configured Python versions (3.10–3.13, skips missing interpreters):

$(poetry env info -p)/bin/tox

Run coverage check (fails under 90%):

$(poetry env info -p)/bin/tox -e coverage

Pass additional pytest arguments via --:

$(poetry env info -p)/bin/tox -e py312 -- -k "test_create_stack" -q

Install the pre-commit hooks (one-time setup):

pip install pre-commit
pre-commit install

Run all hooks manually against all files:

pre-commit run --all-files

Hooks run automatically on git commit and include flake8, black, yamllint, poetry-check, and tox (py312).

poetry run mypy src/

Design documentation lives in .kiro/specs/sceptre-mcp-server/: