|
| 1 | +--- |
| 2 | +title: "Scaffold Any Project with Natural Language: structkit + MCP" |
| 3 | +date: 2026-04-22 |
| 4 | +tags: |
| 5 | + - mcp |
| 6 | + - ai |
| 7 | + - scaffolding |
| 8 | + - platform-engineering |
| 9 | + - claude |
| 10 | +authors: |
| 11 | + - httpdss |
| 12 | +--- |
| 13 | + |
| 14 | +structkit now integrates with the Model Context Protocol (MCP). You can scaffold entire project structures just by describing what you want to Claude. No memorizing CLI flags, no reading docs — just describe the project and it appears. |
| 15 | + |
| 16 | +<!-- more --> |
| 17 | + |
| 18 | +## What is MCP? |
| 19 | + |
| 20 | +The [Model Context Protocol](https://modelcontextprotocol.io) (MCP) is an open standard from Anthropic that lets AI assistants like Claude call external tools. Instead of typing commands, you describe what you want and Claude handles the tooling. |
| 21 | + |
| 22 | +structkit ships with MCP support out of the box. |
| 23 | + |
| 24 | +## Setup |
| 25 | + |
| 26 | +Install structkit: |
| 27 | + |
| 28 | +```bash |
| 29 | +pip install structkit |
| 30 | +``` |
| 31 | + |
| 32 | +Add it to your Claude MCP config (`~/.claude/mcp.json` or your Claude Desktop config): |
| 33 | + |
| 34 | +```json |
| 35 | +{ |
| 36 | + "mcpServers": { |
| 37 | + "structkit": { |
| 38 | + "command": "structkit", |
| 39 | + "args": ["mcp"] |
| 40 | + } |
| 41 | + } |
| 42 | +} |
| 43 | +``` |
| 44 | + |
| 45 | +Restart Claude and structkit tools are now available. |
| 46 | + |
| 47 | +## Example: Scaffold a Python Service |
| 48 | + |
| 49 | +Instead of: |
| 50 | + |
| 51 | +```bash |
| 52 | +structkit generate \ |
| 53 | + --config https://github.com/myorg/templates/python-service.yaml \ |
| 54 | + --var service_name=auth-service \ |
| 55 | + --var port=8080 \ |
| 56 | + --var database=postgres |
| 57 | +``` |
| 58 | + |
| 59 | +You say to Claude: |
| 60 | + |
| 61 | +> "Create a new Python FastAPI service called auth-service, port 8080, PostgreSQL database, with Docker support" |
| 62 | +
|
| 63 | +Claude calls structkit, which generates the full project structure. You see the result appear in your filesystem. |
| 64 | + |
| 65 | +## Example: Terraform Module |
| 66 | + |
| 67 | +> "Scaffold a Terraform module for an AWS S3 bucket with versioning and encryption enabled" |
| 68 | +
|
| 69 | +Result: |
| 70 | + |
| 71 | +``` |
| 72 | +aws-s3-bucket/ |
| 73 | +├── main.tf (with versioning + encryption resources) |
| 74 | +├── variables.tf (name, bucket_name, tags) |
| 75 | +├── outputs.tf (bucket_arn, bucket_id) |
| 76 | +├── README.md (auto-generated docs) |
| 77 | +└── .github/workflows/terraform.yml |
| 78 | +``` |
| 79 | + |
| 80 | +## What structkit Actually Does |
| 81 | + |
| 82 | +structkit is not an AI tool — it is a YAML-first scaffolding engine. MCP is just the interface. Under the hood: |
| 83 | + |
| 84 | +1. You describe what you want |
| 85 | +2. Claude selects or constructs the right structkit template |
| 86 | +3. structkit generates files deterministically from that template |
| 87 | +4. You get real, editable code — not AI-hallucinated code |
| 88 | + |
| 89 | +This matters because your scaffolded project is a structkit template output, not a one-shot AI generation. It is **reproducible, auditable, and follows your organization's standards**. |
| 90 | + |
| 91 | +## The Platform Engineering Use Case |
| 92 | + |
| 93 | +For platform teams, this is the real unlock: |
| 94 | + |
| 95 | +1. Platform team maintains structkit templates (Python service, Go service, Terraform module, etc.) |
| 96 | +2. Product teams use Claude + MCP to scaffold new projects |
| 97 | +3. Every project starts from an approved, standardized template |
| 98 | +4. No copy-paste drift, no "I forgot to add the security scanning step" |
| 99 | + |
| 100 | +Developers get natural-language UX. Platform teams get compliance. |
| 101 | + |
| 102 | +## Try It |
| 103 | + |
| 104 | +```bash |
| 105 | +pip install structkit |
| 106 | +structkit mcp # start the MCP server |
| 107 | +``` |
| 108 | + |
| 109 | +- GitHub: [httpdss/structkit](https://github.com/httpdss/structkit) |
| 110 | +- Docs: [MCP Integration](https://httpdss.github.io/structkit/mcp-integration/) |
| 111 | +- Questions: [GitHub Discussions](https://github.com/httpdss/structkit/discussions) |
| 112 | + |
| 113 | +--- |
| 114 | + |
| 115 | +**Read more:** [Consistent Project Scaffolding at Scale with structkit](../consistent-project-scaffolding-with-structkit.md) | [structkit vs cookiecutter vs copier](../structkit-vs-cookiecutter-vs-copier.md) |
| 116 | + |
| 117 | +--- |
| 118 | + |
| 119 | +*structkit is open source (MIT). Contributions and template shares welcome.* |
0 commit comments