kickpress-mcp — MCP Server for Kickpress

MCP server that exposes Kickpress CLI tools to AI assistants. Lets Claude scaffold and manage Express.js projects directly from a conversation — on your local machine.

Overview

kickpress-mcp runs as a local subprocess on your machine. Claude Desktop spawns it automatically — no server, no configuration, no deployment needed. When a tool runs, it executes on your machine and the project is created in your local environment.

• 4 tools: project scaffolding, CRUD generation, database add, database switch
• Local execution: projects are created on your machine, not a remote server
• Zero config: install and add to Claude Desktop — that's it
• Thin bridge: shells out to npx kickpress — auto-follows new Kickpress releases

Installation

npm install -g kickpress-mcp

Or use directly with npx (no install needed):

{
  "mcpServers": {
    "kickpress": {
      "command": "npx",
      "args": ["kickpress-mcp"]
    }
  }
}

Claude Desktop Setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "kickpress": {
      "command": "npx",
      "args": ["kickpress-mcp"]
    }
  }
}

Restart Claude Desktop. Claude can now scaffold Express.js projects directly from the chat.

Tools

init_project

Scaffold a new Express.js project on your local machine.

| Parameter | Type | Required | Default | Description | |---|---|---|---|---| | name | string | ✓ | — | Project name | | template | api | web | cli | npm | — | api | Project template | | database | sqlite | postgresql | mysql | mongodb | none | — | sqlite | Database provider | | typescript | boolean | — | true | Enable TypeScript | | packageManager | pnpm | npm | yarn | — | pnpm | Package manager |

make_resource

Generate a full CRUD stack for an entity: model, service, controller, routes, validation, and HTTP test file.

| Parameter | Type | Required | Description | |---|---|---|---| | entity | string | ✓ | Entity name (e.g. user, post) | | table | string | — | Custom table name — defaults to {entity}s | | route | string | — | Custom route path — defaults to /{table} | | force | boolean | — | Overwrite existing files |

add_database

Add Prisma database support to an existing project that was created without one.

| Parameter | Type | Required | Description | |---|---|---|---| | database | sqlite | postgresql | mysql | mongodb | ✓ | Database provider |

switch_database

Switch database provider on an existing project. Updates schema and config only — data migration is manual.

| Parameter | Type | Required | Description | |---|---|---|---| | database | sqlite | postgresql | mysql | ✓ | Target database provider |

MongoDB cannot be a switch target — it uses a different Prisma version. Create a new project instead.

Requirements

• Node.js >= 18.0.0
• kickpress available via npx

Available Scripts

pnpm build   # Compile TypeScript to dist/
pnpm start   # Run the compiled server
pnpm dev     # Run directly with tsx (no build step)

Project Structure

kickpress-mcp/
├── src/
│   └── index.ts        # MCP server — tool definitions and handlers
├── dist/               # Compiled output (git-ignored)
├── .github/
│   └── workflows/
│       └── publish.yml # Auto-publish to npm on GitHub release
├── tsconfig.json
└── package.json

License

MIT License

Contact

Marc Tyson Clebert — contact@marctysonclebert.com — @clebertmarctyson

Kickpress scaffolding, straight from your AI assistant.