Cursor Auto-Review MCP Server

MCP server for automated code review, testing, linting, and commit/PR generation.

Features

Available Tools

1. get_diff - Get git diff (staged or working)

2. get_recent_commits - Get recent commit messages

3. run_tests - Run test suite

4. run_lint - Run linter

5. generate_commit_and_pr - Generate commit message and PR description ✨ NEW

New Feature: Commit & PR Generation

The generate_commit_and_pr tool analyzes your changed files and automatically generates:

• Detailed Commit Message with:

  • Conventional commit format (feat/fix/refactor/chore)

  • Change summary

  • File statistics

  • Affected areas

  • File type breakdown

• PR Description with:

  • Summary: Overview of changes

  • Why: Reasons for the changes

  • How: Implementation details

  • Risks/Rollback: Risk assessment and rollback plan

  • Testing Recommendations: Checklist for testing

Usage

Command: /auto-review-commit

When you type /auto-review-commit in Cursor, the AI will:

1. Analyze all changed files (working directory by default)

2. Generate a detailed commit message

3. Generate a comprehensive PR description

4. Provide analysis statistics

Example:

/auto-review-commit

Command: /auto-review

The /auto-review command now includes commit and PR generation at the end:

1. Get git diff

2. Check for linting errors

3. Run tests (if available)

4. Analyze code quality

5. Generate commit message and PR description ✨ NEW

Tool Parameters

generate_commit_and_pr

{
  mode?: "staged" | "working"  // Default: "working"
}

• staged: Analyze staged changes only

• working: Analyze all working directory changes

Output Format

The tool returns a JSON object with:

{
  "commitMessage": "feat(search): improve type safety, add documentation\n\n...",
  "prDescription": "## Summary\n\n...",
  "analysis": {
    "changedFiles": 2,
    "totalAdditions": 150,
    "totalDeletions": 50,
    "affectedAreas": ["app/composables", "app/components"],
    "fileTypes": { "ts": 1, "vue": 1 }
  }
}

Installation

1. Build the project:

npm run build

2. The MCP server is configured in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cursor-auto-review": {
      "command": "node",
      "args": ["/path/to/cursor-autoreview-mcp/dist/index.js"]
    }
  }
}

3. Restart Cursor to load the updated MCP server.

How It Works

Commit Message Generation

The tool analyzes:

• File changes (additions, deletions, modifications)

• Code patterns (type improvements, documentation, constants)

• Affected areas and file types

• Change magnitude (refactor vs feature vs fix)

PR Description Generation

The tool creates sections:

• Summary: High-level overview with statistics

• Why: Extracted from code patterns and change analysis

• How: Detailed breakdown of changes made

• Risks/Rollback: Risk assessment based on change scope and affected areas

• Testing Recommendations: Context-aware testing checklist

Examples

Example 1: Type Safety Improvements

Input: Changed files with FilterItem type imports

Output:

• Commit: refactor(search): improve type safety, extract constants

• PR Why: "Improve type safety and reduce potential runtime errors"

• PR How: "Replaced any[] types with proper FilterItem[] types"

Example 2: Documentation Updates

Input: Files with JSDoc comments added

Output:

• Commit: docs(search): add documentation, improve error handling

• PR Why: "Enhance code documentation and maintainability"

• PR How: "Added JSDoc comments to complex functions"

Development

# Build TypeScript
npm run build

# Run in development (if ts-node is available)
npm start

License

ISC

Cursor-auto-review-mcp