# Zip Hive Scaffold

MCP server for bulk-creating files and folders for any project. Works with Claude Desktop, opencode, Cursor, Windsurf, and any MCP-compatible AI client.

## Quick Start

```bash
curl -fsSL https://ziphive.js.org/mcp/install.sh | bash
```

Then tell your AI:

> Add the MCP server at ~/.ziphive-scaffold/dist/index.js

That's it. The AI will configure itself.

## What it does

Give your AI assistant the ability to create files and folders on your local machine. Say things like:

- "Create a React project called dashboard in ~/projects"
- "Scaffold a Python FastAPI app called backend in /home/user/dev"
- "Add a components/ui folder and Button.tsx to my existing app"
- "Set up a Turborepo monorepo called platform in ~/code"

## Tools

| Tool | Description |
|------|-------------|
| `scaffold_from_template` | Create a project from a built-in template |
| `scaffold_list_templates` | List all available templates |
| `scaffold_create_project` | Create a project from a custom JSON structure |
| `scaffold_create_files` | Add files to an existing directory |
| `scaffold_create_folders` | Create empty folder structures |

## Built-in Templates

| Template | Description |
|----------|-------------|
| `react-vite` | React 18 + Vite + TypeScript |
| `nextjs-app` | Next.js 14 App Router + Tailwind CSS |
| `node-express` | Express REST API + TypeScript |
| `python-fastapi` | FastAPI with async support |
| `vanilla-html` | Minimal HTML/CSS/JS |
| `monorepo-turborepo` | Turborepo monorepo |

## Manual Setup

If you prefer not to use the install script:

```bash
git clone https://github.com/Dqrshan/ziphive-scaffold.git
cd ziphive-scaffold
npm install
npm run build
```

Then tell your AI to add the MCP server pointing to `dist/index.js`.

## Adding Custom Templates

Edit `src/templates/index.ts` and add a new `ProjectStructure` object:

```typescript
templates["my-template"] = {
  name: "my-template",
  description: "My custom template",
  folders: ["src", "tests"],
  files: [
    { path: "package.json", content: "{ ... }" },
    { path: "src/index.ts", content: "..." },
  ],
};
```

Then rebuild: `npm run build`

## License

MIT