# mcp-project-generator

TypeScript MCP server for scaffolding opinionated MCP project templates.

## What it does

- previews template renders
- applies secure generation policy checks
- writes project files
- runs post-generate validation
- ships multiple TypeScript MCP templates
- supports both HTTP and Stdio transports
- emits MCP progress notifications during validation
- sends structured log events for preview/policy/generation requests

## Commands

- `pnpm dev` — HTTP server mode (port 8430)
- `pnpm cli -- list` — list available templates
- `pnpm cli -- preview --template ts-mcp-server --name Example`
- `pnpm cli -- generate --write --template ts-mcp-server --target ./out`
- `pnpm cli -- serve` — alias for pnpm dev
- `pnpm cli -- serve-stdio` — stdio transport mode (for local agent integration)
- `pnpm lint`
- `pnpm test`
- `pnpm typecheck`
- `pnpm build`
- `pnpm validate`

## Transport Modes

- **HTTP** (default): `pnpm cli -- serve` — Streamable HTTP transport on port 8430, ideal for remote clients
- **Stdio**: `pnpm cli -- serve-stdio` — stdin/stdout transport for local agent integration (e.g., Copilot, cursor, bolt)

## Notes

- Templates live in `templates/`
- Spec files live in `.kiro/specs/mcp-project-generator/`
- See [SPEC-COMPLIANCE.md](./SPEC-COMPLIANCE.md) for MCP spec alignment details