create-mcp 0.1.0__tar.gz

create_mcp-0.1.0/.gitignore

@@ -0,0 +1,21 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+
+# uv / venv
+.venv/
+uv.lock
+
+# Caches
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+
+# Editors / OS
+.idea/
+.vscode/
+.DS_Store

create_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Blaze (https://blaze.uz)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

create_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: create-mcp
+Version: 0.1.0
+Summary: The create-next-app for production MCP servers — scaffold a typed, tested, auth-ready Python MCP server in one command.
+Project-URL: Homepage, https://github.com/blaze-uz/create-mcp
+Project-URL: Repository, https://github.com/blaze-uz/create-mcp
+Project-URL: Issues, https://github.com/blaze-uz/create-mcp/issues
+Author-email: Blaze <hello@blaze.uz>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,ai,cli,fastapi,fastmcp,generator,mcp,model-context-protocol,oauth,scaffold
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: jinja2>=3.1
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.15
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# create-mcp
+
+**The `create-next-app` for production MCP servers.**
+
+One command scaffolds a typed, tested, auth-ready Python [MCP](https://modelcontextprotocol.io) server you can *ship* — not just run.
+
+[![CI](https://github.com/blaze-uz/create-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/blaze-uz/create-mcp/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/create-mcp.svg)](https://pypi.org/project/create-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/create-mcp.svg)](https://pypi.org/project/create-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+</div>
+
+```bash
+uvx create-mcp my-server
+```
+
+<!-- A terminal recording (vhs / asciinema) can replace this block before launch. -->
+
+```text
+$ uvx create-mcp
+  Project name: pay-tools
+  Preset:       minimal
+  Transport:    streamable-http
+  Auth:         oauth
+
+  ✓ Scaffolded pay-tools (Minimal · streamable-http · auth: oauth)
+
+  cd pay-tools
+  uv sync            # install dependencies
+  uv run pay_tools   # start the server
+  uv run pytest      # green ✓
+```
+
+## Why
+
+The official MCP SDK quickstart and `create-mcp-server` hand you a single
+hello-world tool and stop. You still have to add tests, typing, linting, CI, a
+Dockerfile, config, and — the hard one — spec-compliant **OAuth 2.1**. Most MCP
+servers in the wild are hello-world demos that never reach production.
+
+`create-mcp` generates the *whole* repo, green on the first run:
+
+- ⚡ **`uvx create-mcp` — zero install.** Same ergonomics as `create-next-app`.
+- 🧱 **Production defaults, not a toy.** Tests, CI, Docker, ruff, mypy, pre-commit, `.env`, a real README.
+- 🔐 **OAuth 2.1 in one flag.** `--auth oauth` scaffolds an [RFC 9728](https://datatracker.ietf.org/doc/html/rfc9728) resource server (Protected Resource Metadata + `401`/`WWW-Authenticate` discovery + JWT validation). Timed for the 2026 MCP authorization spec.
+- 🌊 **Streamable HTTP first.** The modern transport (SSE is deprecated), plus a stdio preset for Claude Desktop / Cursor.
+- 🧪 **Tests pass out of the box.** Generated tests use FastMCP's in-memory client — no network, milliseconds.
+- 🎯 **Presets, not questionnaires.** Scaffold a *use case*: `minimal`, `api-wrapper`, `db`, `agent-tools`.
+- 🐍 **Typed end-to-end.** Pydantic models for tool I/O; ruff- and mypy-clean.
+
+Built on [FastMCP](https://gofastmcp.com) + [`uv`](https://docs.astral.sh/uv/).
+
+## Usage
+
+```bash
+# Interactive
+uvx create-mcp
+
+# Scripted / non-interactive
+uvx create-mcp pay-tools --preset api-wrapper --auth oauth --yes
+```
+
+Then:
+
+```bash
+cd pay-tools
+uv sync
+uv run pay_tools     # start the server
+uv run pytest        # green ✓
+```
+
+### Options
+
+| Flag | Values | Default | Description |
+|------|--------|---------|-------------|
+| `--preset` `-p` | `minimal`, `api-wrapper`, `db`, `agent-tools` | `minimal` | Starting set of tools/resources/prompts |
+| `--transport` `-t` | `streamable-http`, `stdio` | `streamable-http` | MCP transport |
+| `--auth` `-a` | `none`, `oauth` | `none` | OAuth 2.1 resource server (RFC 9728) |
+| `--package-name` | identifier | derived | Override the Python package name |
+| `--output-dir` `-o` | path | `.` | Where to create the project |
+| `--no-git` / `--git` | | `--git` | Initialise a git repo + first commit |
+| `--no-install` / `--install` | | `--install` | Run `uv sync` after scaffolding |
+| `--no-precommit` / `--precommit` | | `--precommit` | Install pre-commit hooks |
+| `--force` | | off | Overwrite a non-empty target directory |
+| `--yes` `-y` | | off | Accept all defaults; never prompt (CI) |
+
+### Presets
+
+| Preset | What you get |
+|--------|--------------|
+| **minimal** | A clean typed server: one tool (structured output), a resource, a prompt. |
+| **api-wrapper** | Wrap an HTTP/JSON API as MCP tools, with the network call isolated for easy mocking. |
+| **db** | A SQLite-backed store exposed as CRUD tools (swap in your real DB). |
+| **agent-tools** | A toolbox for agents: safe calculator, scratchpad memory, clock. |
+
+## What the generated project looks like
+
+```
+my-server/
+├── src/my_server/
+│   ├── server.py      # FastMCP instance (+ /health, + auth when enabled)
+│   ├── tools.py       # your tools, resources, prompts
+│   ├── settings.py    # typed config (pydantic-settings)
+│   ├── app.py         # FastAPI host mounting MCP at /mcp
+│   ├── auth.py        # OAuth 2.1 resource server  (only with --auth oauth)
+│   └── __main__.py    # `uv run my_server`
+├── tests/             # in-memory tests, green out of the box
+├── Dockerfile         # uv-based image
+├── .github/workflows/ci.yml
+├── .pre-commit-config.yaml
+├── .env.example
+└── pyproject.toml
+```
+
+## Requirements
+
+- [`uv`](https://docs.astral.sh/uv/) (for `uvx` and the generated projects)
+- Python 3.11+
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). Every release runs the full matrix —
+generating a project for **each preset × auth mode**, then installing, linting,
+type-checking and testing it — so the templates can't rot silently.
+
+## License
+
+MIT © [Blaze](https://blaze.uz)

create_mcp-0.1.0/README.md

@@ -0,0 +1,131 @@
+<div align="center">
+
+# create-mcp
+
+**The `create-next-app` for production MCP servers.**
+
+One command scaffolds a typed, tested, auth-ready Python [MCP](https://modelcontextprotocol.io) server you can *ship* — not just run.
+
+[![CI](https://github.com/blaze-uz/create-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/blaze-uz/create-mcp/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/create-mcp.svg)](https://pypi.org/project/create-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/create-mcp.svg)](https://pypi.org/project/create-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+</div>
+
+```bash
+uvx create-mcp my-server
+```
+
+<!-- A terminal recording (vhs / asciinema) can replace this block before launch. -->
+
+```text
+$ uvx create-mcp
+  Project name: pay-tools
+  Preset:       minimal
+  Transport:    streamable-http
+  Auth:         oauth
+
+  ✓ Scaffolded pay-tools (Minimal · streamable-http · auth: oauth)
+
+  cd pay-tools
+  uv sync            # install dependencies
+  uv run pay_tools   # start the server
+  uv run pytest      # green ✓
+```
+
+## Why
+
+The official MCP SDK quickstart and `create-mcp-server` hand you a single
+hello-world tool and stop. You still have to add tests, typing, linting, CI, a
+Dockerfile, config, and — the hard one — spec-compliant **OAuth 2.1**. Most MCP
+servers in the wild are hello-world demos that never reach production.
+
+`create-mcp` generates the *whole* repo, green on the first run:
+
+- ⚡ **`uvx create-mcp` — zero install.** Same ergonomics as `create-next-app`.
+- 🧱 **Production defaults, not a toy.** Tests, CI, Docker, ruff, mypy, pre-commit, `.env`, a real README.
+- 🔐 **OAuth 2.1 in one flag.** `--auth oauth` scaffolds an [RFC 9728](https://datatracker.ietf.org/doc/html/rfc9728) resource server (Protected Resource Metadata + `401`/`WWW-Authenticate` discovery + JWT validation). Timed for the 2026 MCP authorization spec.
+- 🌊 **Streamable HTTP first.** The modern transport (SSE is deprecated), plus a stdio preset for Claude Desktop / Cursor.
+- 🧪 **Tests pass out of the box.** Generated tests use FastMCP's in-memory client — no network, milliseconds.
+- 🎯 **Presets, not questionnaires.** Scaffold a *use case*: `minimal`, `api-wrapper`, `db`, `agent-tools`.
+- 🐍 **Typed end-to-end.** Pydantic models for tool I/O; ruff- and mypy-clean.
+
+Built on [FastMCP](https://gofastmcp.com) + [`uv`](https://docs.astral.sh/uv/).
+
+## Usage
+
+```bash
+# Interactive
+uvx create-mcp
+
+# Scripted / non-interactive
+uvx create-mcp pay-tools --preset api-wrapper --auth oauth --yes
+```
+
+Then:
+
+```bash
+cd pay-tools
+uv sync
+uv run pay_tools     # start the server
+uv run pytest        # green ✓
+```
+
+### Options
+
+| Flag | Values | Default | Description |
+|------|--------|---------|-------------|
+| `--preset` `-p` | `minimal`, `api-wrapper`, `db`, `agent-tools` | `minimal` | Starting set of tools/resources/prompts |
+| `--transport` `-t` | `streamable-http`, `stdio` | `streamable-http` | MCP transport |
+| `--auth` `-a` | `none`, `oauth` | `none` | OAuth 2.1 resource server (RFC 9728) |
+| `--package-name` | identifier | derived | Override the Python package name |
+| `--output-dir` `-o` | path | `.` | Where to create the project |
+| `--no-git` / `--git` | | `--git` | Initialise a git repo + first commit |
+| `--no-install` / `--install` | | `--install` | Run `uv sync` after scaffolding |
+| `--no-precommit` / `--precommit` | | `--precommit` | Install pre-commit hooks |
+| `--force` | | off | Overwrite a non-empty target directory |
+| `--yes` `-y` | | off | Accept all defaults; never prompt (CI) |
+
+### Presets
+
+| Preset | What you get |
+|--------|--------------|
+| **minimal** | A clean typed server: one tool (structured output), a resource, a prompt. |
+| **api-wrapper** | Wrap an HTTP/JSON API as MCP tools, with the network call isolated for easy mocking. |
+| **db** | A SQLite-backed store exposed as CRUD tools (swap in your real DB). |
+| **agent-tools** | A toolbox for agents: safe calculator, scratchpad memory, clock. |
+
+## What the generated project looks like
+
+```
+my-server/
+├── src/my_server/
+│   ├── server.py      # FastMCP instance (+ /health, + auth when enabled)
+│   ├── tools.py       # your tools, resources, prompts
+│   ├── settings.py    # typed config (pydantic-settings)
+│   ├── app.py         # FastAPI host mounting MCP at /mcp
+│   ├── auth.py        # OAuth 2.1 resource server  (only with --auth oauth)
+│   └── __main__.py    # `uv run my_server`
+├── tests/             # in-memory tests, green out of the box
+├── Dockerfile         # uv-based image
+├── .github/workflows/ci.yml
+├── .pre-commit-config.yaml
+├── .env.example
+└── pyproject.toml
+```
+
+## Requirements
+
+- [`uv`](https://docs.astral.sh/uv/) (for `uvx` and the generated projects)
+- Python 3.11+
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). Every release runs the full matrix —
+generating a project for **each preset × auth mode**, then installing, linting,
+type-checking and testing it — so the templates can't rot silently.
+
+## License
+
+MIT © [Blaze](https://blaze.uz)

create_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,85 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "create-mcp"
+version = "0.1.0"
+description = "The create-next-app for production MCP servers — scaffold a typed, tested, auth-ready Python MCP server in one command."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Blaze", email = "hello@blaze.uz" }]
+keywords = [
+    "mcp",
+    "model-context-protocol",
+    "fastmcp",
+    "scaffold",
+    "generator",
+    "cli",
+    "fastapi",
+    "oauth",
+    "ai",
+    "agents",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Code Generators",
+    "Typing :: Typed",
+]
+dependencies = [
+    "typer>=0.15",
+    "rich>=13.7",
+    "jinja2>=3.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/blaze-uz/create-mcp"
+Repository = "https://github.com/blaze-uz/create-mcp"
+Issues = "https://github.com/blaze-uz/create-mcp/issues"
+
+[project.scripts]
+create-mcp = "create_mcp.cli:main"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.3",
+    "ruff>=0.7",
+    "mypy>=1.13",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/create_mcp"]
+
+# Ship every template file (including the dot-* placeholders) inside the wheel.
+[tool.hatch.build.targets.sdist]
+include = ["src/create_mcp", "tests", "README.md", "LICENSE"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+# The templates/ tree is rendered Jinja, not importable Python — don't lint it.
+extend-exclude = ["src/create_mcp/templates"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "C4"]
+
+[tool.ruff.lint.per-file-ignores]
+# Typer requires typer.Option/Argument calls in parameter defaults.
+"src/create_mcp/cli.py" = ["B008"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+exclude = ["src/create_mcp/templates"]

create_mcp-0.1.0/src/create_mcp/__init__.py

@@ -0,0 +1,10 @@
+"""create-mcp — scaffold production-ready Python MCP servers in one command."""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+# The FastMCP release the generated projects are pinned to / tested against.
+FASTMCP_TARGET = "3.4"
+
+__all__ = ["__version__", "FASTMCP_TARGET"]

create_mcp-0.1.0/src/create_mcp/__main__.py

@@ -0,0 +1,8 @@
+"""Enable ``python -m create_mcp``."""
+
+from __future__ import annotations
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

create_mcp-0.1.0/src/create_mcp/cli.py

@@ -0,0 +1,193 @@
+"""The ``create-mcp`` command-line interface."""
+
+from __future__ import annotations
+
+import shutil
+import subprocess
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+from rich.prompt import Confirm, Prompt
+from rich.text import Text
+
+from . import FASTMCP_TARGET, __version__
+from .generator import GeneratorError, ProjectConfig, generate, to_package_name
+from .presets import DEFAULT_PRESET, PRESETS, preset_choices
+
+console = Console()
+err_console = Console(stderr=True)
+
+TRANSPORTS = ["streamable-http", "stdio"]
+AUTH_MODES = ["none", "oauth"]
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        console.print(f"create-mcp {__version__} [dim](targets FastMCP {FASTMCP_TARGET}.x)[/dim]")
+        raise typer.Exit()
+
+
+def _run(cmd: list[str], cwd: Path) -> bool:
+    """Run a command, streaming nothing; return True on success, False otherwise."""
+    try:
+        subprocess.run(cmd, cwd=cwd, check=True, capture_output=True)
+        return True
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return False
+
+
+def _maybe_git_init(target: Path) -> None:
+    if shutil.which("git") is None:
+        console.print("  [yellow]›[/yellow] git not found — skipping repository init")
+        return
+    if _run(["git", "init", "-q"], target) and _run(["git", "add", "-A"], target):
+        _run(["git", "commit", "-q", "-m", "Initial commit (create-mcp)"], target)
+        console.print("  [green]✓[/green] initialised git repository")
+    else:
+        console.print("  [yellow]›[/yellow] could not initialise git repository")
+
+
+def _maybe_uv_sync(target: Path) -> None:
+    if shutil.which("uv") is None:
+        console.print("  [yellow]›[/yellow] uv not found — skipping dependency install")
+        return
+    console.print("  [dim]…[/dim] installing dependencies with uv")
+    if _run(["uv", "sync"], target):
+        console.print("  [green]✓[/green] installed dependencies (uv sync)")
+    else:
+        console.print("  [yellow]›[/yellow] uv sync failed — run it yourself later")
+
+
+def _maybe_precommit(target: Path) -> None:
+    if shutil.which("git") is None or not (target / ".git").exists():
+        return
+    if shutil.which("uv") is not None and _run(["uv", "run", "pre-commit", "install"], target):
+        console.print("  [green]✓[/green] installed pre-commit hooks")
+
+
+def _prompt_choice(label: str, choices: list[str], default: str) -> str:
+    return Prompt.ask(f"[bold]{label}[/bold]", choices=choices, default=default)
+
+
+def create(  # noqa: C901 - the CLI orchestration is intentionally linear
+    project_name: str = typer.Argument(None, help="Name of the project / directory to create."),
+    preset: str = typer.Option(
+        None, "--preset", "-p", help=f"Preset: {', '.join(preset_choices())}."
+    ),
+    transport: str = typer.Option(
+        None, "--transport", "-t", help="Transport: streamable-http or stdio."
+    ),
+    auth: str = typer.Option(
+        None, "--auth", "-a", help="Auth mode: none or oauth (OAuth 2.1 resource server)."
+    ),
+    package_name: str = typer.Option(
+        None, "--package-name", help="Override the derived Python package name."
+    ),
+    description: str = typer.Option(None, "--description", help="One-line project description."),
+    output_dir: Path = typer.Option(
+        None, "--output-dir", "-o", help="Directory to create the project in (default: cwd)."
+    ),
+    do_git: bool = typer.Option(True, "--git/--no-git", help="Initialise a git repository."),
+    do_install: bool = typer.Option(
+        True, "--install/--no-install", help="Run `uv sync` after scaffolding."
+    ),
+    do_precommit: bool = typer.Option(
+        True, "--precommit/--no-precommit", help="Install pre-commit hooks."
+    ),
+    force: bool = typer.Option(False, "--force", help="Overwrite a non-empty target directory."),
+    yes: bool = typer.Option(
+        False, "--yes", "-y", help="Accept all defaults; never prompt (CI / scripting)."
+    ),
+    _version: bool = typer.Option(
+        None, "--version", callback=_version_callback, is_eager=True, help="Show version."
+    ),
+) -> None:
+    """Scaffold a production-ready Python MCP server."""
+    interactive = not yes
+    output_dir = output_dir or Path.cwd()
+
+    def choose(label: str, choices: list[str], default: str, current: str | None) -> str:
+        if current is not None:
+            return current
+        return _prompt_choice(label, choices, default) if interactive else default
+
+    if not project_name:
+        if interactive:
+            project_name = Prompt.ask("[bold]Project name[/bold]", default="my-mcp-server")
+        else:
+            err_console.print("[red]error:[/red] project name is required with --yes")
+            raise typer.Exit(code=2)
+
+    preset = choose("Preset", preset_choices(), DEFAULT_PRESET, preset)
+    transport = choose("Transport", TRANSPORTS, "streamable-http", transport)
+    auth = choose("Auth", AUTH_MODES, "none", auth)
+
+    if interactive:
+        do_git = Confirm.ask("Initialise a git repository?", default=do_git)
+        do_install = Confirm.ask("Install dependencies now (uv sync)?", default=do_install)
+        if do_git:
+            do_precommit = Confirm.ask("Install pre-commit hooks?", default=do_precommit)
+
+    try:
+        config = ProjectConfig(
+            project_name=project_name,
+            preset=preset,
+            transport=transport,
+            auth=auth,
+            description=description or "",
+        )
+        if package_name:
+            # Validate + override the derived package name.
+            config.package_name = to_package_name(package_name)
+        target = output_dir / project_name
+        generate(config, target, force=force)
+    except GeneratorError as exc:
+        err_console.print(f"[red]error:[/red] {exc}")
+        raise typer.Exit(code=1) from exc
+
+    console.print()
+    console.print(
+        f"[green]✓[/green] Scaffolded [bold]{project_name}[/bold] "
+        f"[dim]({PRESETS[preset].title} · {transport} · auth: {auth})[/dim]"
+    )
+
+    if do_git:
+        _maybe_git_init(target)
+    if do_install:
+        _maybe_uv_sync(target)
+    if do_precommit:
+        _maybe_precommit(target)
+
+    _print_next_steps(config, target, output_dir)
+
+
+def _print_next_steps(config: ProjectConfig, target: Path, output_dir: Path) -> None:
+    rel = target.relative_to(output_dir) if target.is_relative_to(output_dir) else target
+    pkg = config.package_name
+    run_cmd = f"uv run {pkg}"
+    body = Text()
+    body.append("Next steps\n\n", style="bold")
+    body.append(f"  cd {rel}\n")
+    body.append("  uv sync                  ", style="cyan")
+    body.append("# install dependencies\n", style="dim")
+    body.append(f"  {run_cmd}{' ' * max(1, 17 - len(run_cmd))}", style="cyan")
+    body.append(f"# run the server ({config.transport})\n", style="dim")
+    body.append("  uv run pytest            ", style="cyan")
+    body.append("# run the test suite\n\n", style="dim")
+    body.append("Inspect it with the MCP Inspector:\n")
+    body.append(f"  npx @modelcontextprotocol/inspector uv run {pkg}\n", style="cyan")
+    if config.auth_enabled:
+        body.append("\nAuth is on. ", style="bold yellow")
+        body.append("Set OAUTH_* vars in .env (see .env.example) and point them at\n")
+        body.append("your identity provider (Keycloak / WorkOS / Auth0 / Azure).")
+    console.print(Panel(body, border_style="green", expand=False))
+
+
+def main() -> None:
+    typer.run(create)
+
+
+if __name__ == "__main__":
+    main()