Prisma Cursor Plugin

February 4, 2026 ยท View on GitHub

A comprehensive Cursor plugin for Prisma development, providing MCP server integration, AI rules, specialized skills, custom agents, and automation hooks.

Features

๐Ÿ”Œ MCP Server Integration

  • Direct integration with Prisma MCP server
  • Database introspection and querying
  • Schema management through AI

๐Ÿ“‹ Rules

  • Schema Conventions: Enforces Prisma naming conventions and best practices
  • Migration Best Practices: Guidelines for safe database migrations

๐ŸŽฏ Skills

  • Schema Designer: Design and modify Prisma schemas following best practices
  • Migration Manager: Safely create, deploy, and manage database migrations

๐Ÿค– Custom Agents

  • Prisma Expert: Comprehensive Prisma development expertise
  • Schema Reviewer: Specialized schema review and optimization

โšก Automation Hooks

  • Pre-commit: Validates Prisma schema before commits
  • Post-save: Auto-formats Prisma schema files on save
  • On-schema-change: Regenerates TypeScript types after schema changes

Installation

From Cursor Marketplace

# Install via Cursor CLI
cursor plugin install prisma-cursor-plugin

Manual Installation

  1. Clone this repository
  2. Copy to your Cursor plugins directory
  3. Run setup script:
npm run setup

Configuration

Database Connection

Create a .env file in your project root:

DATABASE_URL="postgresql://user:password@localhost:5432/mydb"

MCP Server

The Prisma MCP server is automatically configured. Ensure your DATABASE_URL environment variable is set.

Usage

Using Rules

Rules are automatically applied to your Prisma schema files:

  • Schema conventions enforce naming standards
  • Migration best practices guide safe database changes

Using Skills

Invoke skills via Cursor AI:

  • /schema-designer - Design new schemas or modify existing ones
  • /migration-manager - Create and manage migrations

Using Agents

Switch to custom agents in Cursor:

  • Prisma Expert: For general Prisma development tasks
  • Schema Reviewer: For schema reviews and optimization

Automation Hooks

Hooks run automatically on configured events:

  • Schema validation before commits
  • Auto-formatting on save
  • Type generation after schema changes

Project Structure

prisma-cursor-plugin/
โ”œโ”€โ”€ .cursor/
โ”‚   โ””โ”€โ”€ plugin.json           # Plugin manifest
โ”œโ”€โ”€ rules/
โ”‚   โ”œโ”€โ”€ schema-conventions.mdc
โ”‚   โ””โ”€โ”€ migration-best-practices.mdc
โ”œโ”€โ”€ skills/
โ”‚   โ”œโ”€โ”€ schema-designer/
โ”‚   โ”‚   โ””โ”€โ”€ SKILL.md
โ”‚   โ””โ”€โ”€ migration-manager/
โ”‚       โ””โ”€โ”€ SKILL.md
โ”œโ”€โ”€ agents/
โ”‚   โ”œโ”€โ”€ prisma-expert.md
โ”‚   โ””โ”€โ”€ schema-reviewer.md
โ”œโ”€โ”€ scripts/
โ”‚   โ”œโ”€โ”€ setup.sh
โ”‚   โ”œโ”€โ”€ pre-commit.sh
โ”‚   โ”œโ”€โ”€ format-schema.js
โ”‚   โ””โ”€โ”€ generate-types.ts
โ”œโ”€โ”€ hooks.json                # Hook definitions
โ”œโ”€โ”€ mcp.json                  # MCP server configuration
โ”œโ”€โ”€ package.json
โ””โ”€โ”€ README.md

Development

Scripts

# Setup the plugin
npm run setup

# Build MCP server (when implemented)
npm run build

# Development mode (when implemented)
npm run dev

# Run code generation scripts
npm run generate

Requirements

  • Node.js >= 18
  • Prisma CLI (installed automatically by setup)
  • Database connection (PostgreSQL, MySQL, SQLite, etc.)

Examples

Creating a Schema

model User {
  id        Int      @id @default(autoincrement())
  email     String   @unique
  name      String?
  posts     Post[]
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  @@index([email])
}

model Post {
  id          Int      @id @default(autoincrement())
  title       String
  content     String?
  published   Boolean  @default(false)
  authorId    Int
  author      User     @relation(fields: [authorId], references: [id])
  createdAt   DateTime @default(now())
  updatedAt   DateTime @updatedAt

  @@index([authorId])
  @@index([published])
}

Creating a Migration

# Create and apply migration
npx prisma migrate dev --name add_user_posts

# Deploy to production
npx prisma migrate deploy

Contributing

Contributions are welcome! Please follow Prisma's contribution guidelines.

License

MIT

Support