Home
Login

Cursor and Windsurf community rules and MCP server directory platform

TypeScript 3.4kpontusabdirectories Last Updated: 2025-07-04

Directories - Community Rules and MCP Server Directory for Cursor and Windsurf

Project Overview

Directories is an open-source project specifically designed for the Cursor and Windsurf communities, primarily serving as a centralized management and sharing platform for rules and Model Context Protocol (MCP) servers. Developed and maintained by Pontus Abrahamsson, the project aims to help developers better leverage AI-assisted programming tools.

Key Features

1. Rule Management System

  • Centralized Rule Storage: Manages various development rules and prompts centrally within the packages/data/rules/ directory.
  • Standardized Format: Each rule includes a unified parameter format to ensure consistency and usability.
  • Categorized Management: Organized by programming language, framework, or tool.

2. Community Contribution Mechanism

  • Open Contribution: Any developer can submit new rules or improve existing ones.
  • Standardized Process: Provides detailed contribution guidelines to ensure code quality and adherence to standards.
  • Testing and Validation: Requires contributors to test prompts to ensure they function correctly in relevant development environments.

3. MCP Server Integration

  • MCP Support: Supports Model Context Protocol, enhancing the interactive capabilities of AI tools.
  • Multi-Tool Compatibility: Supports both Cursor and Windsurf, two major AI programming tools.

Technical Architecture

Project Structure

directories/
├── packages/
│   └── data/
│       └── rules/
│           ├── index.ts          # Rule index file
│           └── rules/            # Directory for specific rule files
│               ├── c.ts
│               ├── nextjs.ts
│               └── ...
├── apps/
│   ├── cursor/                   # Cursor-related configurations
│   └── windsurf/                 # Windsurf-related configurations

Rule Definition Format

Each rule file must include the following standard parameters:

{
  tags: ["JavaScript", "Next.js"],           // Language-specific tags
  title: "Next.js Best Practices",           // Rule title
  slug: "nextjs-best-practices",             // Unique identifier
  content: `your amazing prompt`,            // Prompt content
  author: {                                  // Author information
    name: "Your Name",
    url: "https://github.com/username",
    avatar: "avatar-url"
  }
}

Usage

Development Environment Setup

# Install dependencies
npm install

# Start development server
npm run dev
# Or
yarn dev
# Or
pnpm dev
# Or
bun dev

# Access http://localhost:3000

Adding New Rules

  1. Locate Rule Index: Add the import for the new rule in packages/data/rules/index.ts.

    import { cRules } from "./rules/c";
    
  2. Create Rule File: Create a new rule file in the packages/data/rules/ directory.

    // e.g.: nextjs.ts
    export const nextjsRules = {
      // Rule definition
    };
    
  3. Define Rule Content: Write the rule according to the standard format, ensuring:

    • Accuracy: Relevant and accurate to the rule.
    • Clarity: Clearly worded for easy understanding and use by developers.
    • Actionability: Provides concrete steps or insights to solve common problems.

Updating Existing Rules

  1. Locate the relevant rule file.
  2. Add new content below the existing prompt.
  3. Ensure the newly added content is tested and validated.

Community Features

Quality Assurance

  • Testing Requirements: All prompts must be tested and validated.
  • Accuracy Guarantee: Ensures the accuracy and practicality of rule content.
  • Continuous Improvement: The community continuously maintains and improves existing rules.

Developer Friendly

  • Detailed Documentation: Provides comprehensive contribution guidelines and usage instructions.
  • Standardized Process: Unified rule format and submission process.
  • Recognition Mechanism: Showcases contributors' contributions through author information.

Tool Integration

  • Multi-Editor Support: Supports both Cursor and Windsurf.
  • Real-time Application: Supports automatic rule application and intelligent matching of file path patterns.
  • MCP Integration: Supports the Model Context Protocol (MCP) to enhance AI interaction capabilities.

Project Advantages

  1. Centralized Management: Centralizes scattered rules and prompts, making them easy to find and use.
  2. Standardized Format: Unified rule format ensures compatibility and maintainability.
  3. Community-Driven: Open contribution mechanism promotes knowledge sharing and continuous improvement.
  4. Tool-Agnostic: Supports multiple AI programming tools, increasing applicability.
  5. Quality Assurance: Rigorous testing and validation processes ensure the effectiveness of rules.

Application Scenarios

  • AI-Assisted Programming: Provides optimized programming rules for Cursor and Windsurf users.
  • Team Collaboration: Teams can share and standardize programming conventions.
  • Skill Enhancement: New developers can learn best practices.
  • Tool Optimization: Enhances AI tool functionality through the MCP protocol.

Summary

The Directories project is a community platform focused on AI-assisted programming, providing developers with a standardized, high-quality resource library through centralized management of rules and MCP server configurations. This project not only improves development efficiency but also promotes the dissemination and application of AI programming best practices.

Star History Chart