Scaffold Python projects from YAML presets, augment existing projects with CI/tests.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag β we're steadily working through the catalog.
π‘ Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
A meta-tool for scaffolding Python projects with configurable YAML presets.
Supports Poetry, uv, and setuptools, generates CI workflows, testing scaffolds, type checking configs, and more.
mcp-name: io.github.KaiErikNiermann/pypreset
src/ layout and flat layout.dockerignore, and VS Code devcontainer configs (Docker or Podman).python-version for pyenv and uv, with python-version-file in CI workflowsgh CLIact (auto-detect, auto-install, dry-run and full-run modes)pyproject.toml metadata~/.config/pypreset/config.yamlcreate -- Scaffold a new project| Option | Description |
|---|---|
--preset, -p | Preset to use (default: empty-package) |
--output, -o | Output directory (default: .) |
--config, -c | Custom preset YAML file |
--package-manager | poetry or uv |
--layout | src or flat |
--type-checker | mypy, pyright, ty, or none |
--typing | none, basic, or strict |
--python-version | e.g., 3.12 |
--testing / --no-testing | Enable/disable testing scaffold |
--formatting / --no-formatting | Enable/disable formatting config |
--radon / --no-radon | Enable radon complexity checking |
--pre-commit / --no-pre-commit | Generate pre-commit hooks config |
--bump-my-version / --no-bump-my-version | Include bump-my-version config |
--extra-package, -e | Additional packages (repeatable) |
--extra-dev-package, -d | Additional dev packages (repeatable) |
--docker / --no-docker | Generate Dockerfile and .dockerignore |
--devcontainer / --no-devcontainer | Generate .devcontainer/ configuration |
--container-runtime | docker or podman |
--coverage-tool | codecov or none |
--coverage-threshold | Minimum coverage % (e.g., 80) |
--docs | sphinx, mkdocs, or none |
--docs-gh-pages / --no-docs-gh-pages | Generate GitHub Pages deploy workflow |
--tox / --no-tox | Generate tox.ini with tox-uv backend |
--pyenv / --no-pyenv | Generate .python-version and use python-version-file in CI |
--git / --no-git | Initialize git repository |
--install / --no-install | Run dependency install after creation |
--dry-run | Preview what would be created without generating anything |
augment -- Add components to an existing projectAnalyzes pyproject.toml to auto-detect your tooling, then generates the selected components. Runs in interactive mode by default (prompts for values it can't detect); use --auto to skip prompts.
Available components:
| Flag | Component | What it generates |
|---|---|---|
--test-workflow / --no-test-workflow | Test CI | GitHub Actions workflow that runs pytest across a Python version matrix |
--lint-workflow / --no-lint-workflow | Lint CI | GitHub Actions workflow for ruff, type checking, and complexity analysis |
--dependabot / --no-dependabot | Dependabot | .github/dependabot.yml for automated dependency updates |
--tests / --no-tests | Tests directory | tests/ with template test files and conftest.py |
--gitignore / --no-gitignore | Gitignore | Python-specific .gitignore |
--pypi-publish / --no-pypi-publish | PyPI publish | GitHub Actions workflow for OIDC-based publishing to PyPI on release |
--dockerfile / --no-dockerfile | Docker | Multi-stage Dockerfile and .dockerignore (Poetry, uv, or setuptools aware) |
--devcontainer / --no-devcontainer | Devcontainer | .devcontainer/devcontainer.json with VS Code extensions |
--codecov / --no-codecov | Codecov | codecov.yml configuration |
--docs | Documentation | Sphinx or MkDocs scaffolding (--docs sphinx or --docs mkdocs) |
--tox / --no-tox | tox | tox.ini with tox-uv backend for multi-environment testing |
--readme / --no-readme | README | README.md generated from the shared template (badges, install, features) |
--pyenv / --no-pyenv | pyenv | .python-version file for pyenv and uv version pinning |
workflow -- Local workflow verificationVerify GitHub Actions workflows locally using act. The proxy auto-detects whether act is installed, can install it on supported systems, and surfaces all act output directly.
Supported auto-install targets: Arch Linux (pacman), Ubuntu/Debian (apt), Fedora (dnf), macOS/Linux with Homebrew. Other systems get a link to the act installation page.
version -- Release managementRequires the gh CLI to be installed and authenticated.
metadata -- PyPI metadata managementbadges -- Generate badge markdownReads pyproject.toml to detect your project name, repository URL, and license, then prints badge markdown you can paste into your README.
Factual signals from GitHub, npm, and our automated checks β not a rating.
No reviews yet β be the first to share how this listing worked for you.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/pypreset)<a href="https://allmcps.com/mcp/pypreset"><img src="https://allmcps.com/api/badge/pypreset?style=directory" alt="Pypreset on AllMCPs" /></a>