pip install -e ".[dev]"
x4-mcpgen init weather --tools 2
cd weather
pip install -e ".[dev]"
pytest -q
x4-mcpgen validate .
x4-mcpgen test .

x4-mcpgen init <name> [--tools N] [--out DIR]
x4-mcpgen validate [PATH]
x4-mcpgen test [PATH]
x4-mcpgen package [PATH]
x4-mcpgen doctor

my-mcp/
├── src/<pkg>/
│   ├── server.py
│   └── tools/
├── tests/
├── schemas/
├── Dockerfile
├── mcp.json
├── pyproject.toml
├── README.md
├── SECURITY.md
├── LICENSE
└── .github/workflows/ci.yml

flowchart TD
    SPEC[Tool Definitions] --> VALID[Validate Configuration]
    VALID --> GEN[Generate MCP Project]
    GEN --> SRC[Server and Tool Modules]
    GEN --> TEST[Generated Tests]
    GEN --> POLICY[Allow-list and stdio-first Config]
    GEN --> DOCS[Security Docs and License]
    GEN --> CI[CI and Container Files]
    SRC --> CHECK[Validate and Test Generated Project]
    TEST --> CHECK
    POLICY --> CHECK
    DOCS --> CHECK
    CI --> CHECK

flowchart LR
  Source[Canonical tool contract] --> Normalize[Normalize names and types]
  Normalize --> Validate[Validate schema constraints]
  Validate -->|invalid| Diagnostics[Actionable schema errors]
  Validate -->|valid| Generate[Generate protocol schema artifacts]
  Generate --> Determinism{Repeat generation identical?}
  Determinism -->|no| Fail[Fail determinism test]
  Determinism -->|yes| Fixtures[Update or compare golden fixtures]
  Fixtures --> Consumer[Compile / validate sample consumer]
  Consumer --> Compat{Breaking change detected?}
  Compat -->|yes| Major[Require explicit version bump]
  Compat -->|no| Package[Package generated artifacts]
  Package --> Provenance[Record generator and input version]