# Awesome Cursor Rules MDC — Auto-Generated .mdc Files

> Collection of auto-generated Cursor .mdc rule files for 800+ libraries using Exa search and LLM. Drop into .cursor/rules/ for AI-aware coding standards. CC0, 3,400+ stars.

## Install

Save in your project root:

## Quick Use

1. Browse rules: [github.com/sanjeed5/awesome-cursor-rules-mdc](https://github.com/sanjeed5/awesome-cursor-rules-mdc)
2. Find your framework/library in the `rules-mdc/` directory
3. Copy the `.mdc` file to your project's `.cursor/rules/` directory
4. Cursor auto-loads the rules on next session

Or generate custom rules:
```bash
git clone https://github.com/sanjeed5/awesome-cursor-rules-mdc.git
cd awesome-cursor-rules-mdc
uv run src/generate_mdc_files.py --library "fastapi"
```

---

## Intro

Awesome Cursor Rules MDC is a collection of 800+ auto-generated `.mdc` (Markdown Cursor) rule files for Cursor AI editor, with 3,400+ GitHub stars and CC0 (public domain) license. Unlike hand-written `.cursorrules` files, these are generated using Exa semantic search to gather real-world best practices, then LLM (Gemini/OpenAI/Anthropic) to create structured coding guidelines. Drop any `.mdc` file into your project's `.cursor/rules/` directory and Cursor immediately follows your framework's conventions — React patterns, Python style, Rust idioms, and more.

Best for: Cursor users who want instant, high-quality coding rules for any library without writing them manually.
Works with: Cursor 2.2+ (`.mdc` format), any framework/library.
Setup time: under 1 minute.

---

## How .mdc Rules Work

### What's in a .mdc File

Each `.mdc` file contains structured coding guidelines:
- Framework-specific best practices
- Naming conventions and patterns
- Common anti-patterns to avoid
- Import/export standards
- Testing conventions
- Performance recommendations

### .mdc vs .cursorrules

| Feature | .cursorrules (legacy) | .mdc (current) |
|---------|----------------------|----------------|
| Format | Plain text | Structured markdown |
| Scoping | Project-wide only | Glob-scoped per file type |
| Metadata | None | Frontmatter with description |
| Organization | Single file | Multiple files in `.cursor/rules/` |
| Future | Being deprecated | Recommended format |

### Generation Pipeline

1. **Exa Semantic Search** — Finds real-world best practices, official docs, community patterns
2. **LLM Processing** — Structures findings into .mdc format (supports Gemini, OpenAI, Anthropic)
3. **Parallel Processing** — Generates multiple libraries simultaneously
4. **Smart Retry** — Failed generations auto-retry on next run

### Custom Generation

Generate rules for any library:
```bash
uv run src/generate_mdc_files.py --library "next.js"
uv run src/generate_mdc_files.py --tag "python"
uv run src/generate_mdc_files.py --regenerate-all
```

### FAQ

**Q: What is Awesome Cursor Rules MDC?**
A: A collection of 800+ auto-generated .mdc rule files for Cursor AI, created using Exa search + LLM. Drop into `.cursor/rules/` for instant framework-specific coding standards.

**Q: Is it free?**
A: CC0 public domain — copy, modify, use for anything.

**Q: How do I use a rule?**
A: Copy the `.mdc` file to your project's `.cursor/rules/` directory. Cursor auto-loads it.

---

## Source & Thanks

> Created by [sanjeed5](https://github.com/sanjeed5). Licensed under CC0 1.0.
>
> [awesome-cursor-rules-mdc](https://github.com/sanjeed5/awesome-cursor-rules-mdc) — ⭐ 3,400+

---

<!-- ZH -->

## 快速使用

1. 浏览 `rules-mdc/` 目录找到你的框架
2. 复制 `.mdc` 文件到项目的 `.cursor/rules/` 目录
3. Cursor 下次会话自动加载

---

## 简介

800+ 个自动生成的 Cursor `.mdc` 规则文件，使用 Exa 语义搜索 + LLM 生成。CC0 公共领域许可，3,400+ Star。放入 `.cursor/rules/` 即可让 Cursor 遵循框架最佳实践。

---

## 来源与感谢

> Created by [sanjeed5](https://github.com/sanjeed5). Licensed under CC0 1.0.
>
> [awesome-cursor-rules-mdc](https://github.com/sanjeed5/awesome-cursor-rules-mdc) — ⭐ 3,400+

---
Source: https://tokrepo.com/en/workflows/f38ab5c1-c3f6-4d0c-b055-37dbfb654e31
Author: AI Open Source