Cursor and Windsurf community rules and MCP server directory platform
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
Locate Rule Index: Add the import for the new rule in
packages/data/rules/index.ts
.import { cRules } from "./rules/c";
Create Rule File: Create a new rule file in the
packages/data/rules/
directory.// e.g.: nextjs.ts export const nextjsRules = { // Rule definition };
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
- Locate the relevant rule file.
- Add new content below the existing prompt.
- 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
- Centralized Management: Centralizes scattered rules and prompts, making them easy to find and use.
- Standardized Format: Unified rule format ensures compatibility and maintainability.
- Community-Driven: Open contribution mechanism promotes knowledge sharing and continuous improvement.
- Tool-Agnostic: Supports multiple AI programming tools, increasing applicability.
- 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.