# {{ project_name }}
{{ description }}
## Quickstart
- Install (dev):
- `python -m pip install -e .[dev]`
- Run (stdio):
- `python -m {{ package_name }}.server`
- Test:
- `pytest -v`
- Makefile targets:
- `make dev` — runs stdio server
- `make test` — pytest with coverage
- `make format` / `make lint`
{%- if include_http_bridge %}
- `make serve-http` — expose stdio server over HTTP via gateway translate
- `make test-http` — quick HTTP checks
{%- endif %}
## MCP Client Snippet
Use this snippet in your MCP client configuration (e.g., Claude Desktop):
```json
{"command": "python", "args": ["-m", "{{ package_name }}.server"], "cwd": "."}
```
## Container
Build and run with a local container runtime (Docker/Podman):
```bash
# Build
podman build -f Containerfile -t {{ dist_name }}:{{ version }} .
# Run
podman run --rm -it {{ dist_name }}:{{ version }}
```
## License
{{ license }}
