Directories - Cursor 和 Windsurf 社区规则与 MCP 服务器目录

项目概述

Directories 是一个专为 Cursor 和 Windsurf 社区设计的开源项目，主要提供规则（Rules）和 MCP（Model Context Protocol）服务器的集中管理和分享平台。该项目由 Pontus Abrahamsson 开发维护，旨在帮助开发者更好地利用 AI 辅助编程工具。

主要功能

1. 规则管理系统

• 集中化规则存储: 将各种开发规则和提示词集中管理在 packages/data/rules/ 目录下
• 标准化格式: 每个规则都包含统一的参数格式，确保一致性和可用性
• 分类管理: 按照编程语言、框架或工具进行分类组织

2. 社区贡献机制

• 开放贡献: 任何开发者都可以提交新的规则或改进现有规则
• 规范化流程: 提供详细的贡献指南，确保代码质量和规范性
• 测试验证: 要求贡献者测试提示词，确保其在相关开发环境中正常工作

3. MCP 服务器集成

• MCP 支持: 支持 Model Context Protocol，增强 AI 工具的交互能力
• 多工具兼容: 同时支持 Cursor 和 Windsurf 两大主流 AI 编程工具

技术架构

项目结构

directories/
├── packages/
│   └── data/
│       └── rules/
│           ├── index.ts          # 规则索引文件
│           └── rules/            # 具体规则文件目录
│               ├── c.ts
│               ├── nextjs.ts
│               └── ...
├── apps/
│   ├── cursor/                   # Cursor 相关配置
│   └── windsurf/                 # Windsurf 相关配置

规则定义格式

每个规则文件需要包含以下标准参数：

{
  tags: ["JavaScript", "Next.js"],           // 语言特定标签
  title: "Next.js Best Practices",           // 规则标题
  slug: "nextjs-best-practices",             // 唯一标识符
  content: `your amazing prompt`,            // 提示词内容
  author: {                                  // 作者信息
    name: "Your Name",
    url: "https://github.com/username",
    avatar: "avatar-url"
  }
}

使用方法

开发环境搭建

# 安装依赖
npm install

# 启动开发服务器
npm run dev
# 或者
yarn dev
# 或者
pnpm dev
# 或者
bun dev

# 访问 http://localhost:3000

添加新规则

1. 定位规则索引: 在 packages/data/rules/index.ts 文件中添加新规则的导入

   import { cRules } from "./rules/c";
   

2. 创建规则文件: 在 packages/data/rules/ 目录下创建新的规则文件

   // 例如：nextjs.ts
   export const nextjsRules = {
     // 规则定义
   };
   

3. 定义规则内容: 按照标准格式编写规则，确保：

   • 准确性：与规则相关且准确
   • 清晰性：措辞清晰，便于开发者理解和使用
   • 可操作性：提供具体步骤或见解来解决常见问题

更新现有规则

1. 找到相关规则文件
2. 在现有提示词下方添加新内容
3. 确保新添加的内容经过测试验证

社区特色

质量保证

• 测试要求: 所有提示词必须经过测试验证
• 准确性保证: 确保规则内容的准确性和实用性
• 持续改进: 社区持续维护和改进现有规则

开发者友好

• 详细文档: 提供完整的贡献指南和使用说明
• 标准化流程: 统一的规则格式和提交流程
• 认可机制: 通过作者信息展示贡献者的贡献

工具集成

• 多编辑器支持: 同时支持 Cursor 和 Windsurf
• 实时应用: 支持自动应用规则，智能匹配文件路径模式
• MCP 集成: 支持 Model Context Protocol 协议，增强 AI 交互能力

项目优势

1. 集中化管理: 将分散的规则和提示词集中管理，便于查找和使用
2. 标准化格式: 统一的规则格式确保兼容性和可维护性
3. 社区驱动: 开放的贡献机制促进知识共享和持续改进
4. 工具无关: 同时支持多种 AI 编程工具，提高适用性
5. 质量保证: 严格的测试和验证流程确保规则的有效性

应用场景

• AI 辅助编程: 为 Cursor 和 Windsurf 用户提供优化的编程规则
• 团队协作: 团队可以共享和标准化编程规范
• 技能提升: 新手开发者可以学习最佳实践
• 工具优化: 通过 MCP 协议增强 AI 工具的功能

总结

Directories 项目是一个专注于 AI 辅助编程的社区平台，通过集中管理规则和 MCP 服务器配置，为开发者提供了一个标准化、高质量的资源库。该项目不仅提高了开发效率，还促进了 AI 编程最佳实践的传播和应用。