Cursor rule

1# 🔌 CursorRIPER Σ MCP Master Configuration
2# Version: 1.1.0
3# Enable/disable MCP services by uncommenting @file directives
4 
5## 📋 MCP Service Integration for CursorRIPER Σ
6 
7This configuration file enables Model Context Protocol (MCP) services
8within the CursorRIPER Σ framework. Each service is modular and optional.
9 
10### 🛠️ Available Services:
11 
12#### Φ - Filesystem Operations
13# Provides local file system access and manipulation
14# @file .cursor/rules/mcp_filesystem.mdc
15 
16#### Θ - GitHub Operations  
17# GitHub repository management and collaboration
18# Requires: GITHUB_TOKEN environment variable
19# @file .cursor/rules/mcp_github.mdc
20 
21#### Λ - Web Search Operations
22# Web search capabilities via Brave Search API
23# Requires: BRAVE_SEARCH_API_KEY environment variable
24# @file .cursor/rules/mcp_websearch.mdc
25 
26#### Υ - Browser Automation Operations
27# Puppeteer/Playwright browser automation and testing
28# @file .cursor/rules/mcp_puppeteer.mdc
29 
30#### Ξ - Container Operations
31# Docker container and compose management
32# Requires: Docker daemon running
33# @file .cursor/rules/mcp_docker.mdc
34 
35### 📝 Configuration Instructions:
36 
371. **Install MCP servers** for desired services:
38```bash
39   # Filesystem (included with Cursor)
40   # No installation needed
41   
42   # GitHub
43   npm install -g @modelcontextprotocol/server-github
44   
45   # Web Search
46   npm install -g @modelcontextprotocol/server-brave-search
47   
48   # Puppeteer
49   npm install -g @modelcontextprotocol/server-puppeteer
50   # OR Playwright (recommended)
51   npm install -g @executeautomation/playwright-mcp-server
52   
53   # Docker
54   npm install -g docker-mcp
55```
56 
572. **Set environment variables**:
58   - `GITHUB_TOKEN`: Personal access token for GitHub
59   - `BRAVE_SEARCH_API_KEY`: API key from brave.com/search/api
60 
613. **Uncomment @file directives** above for services you want to enable
62 
634. **Update .cursor/mcp.json** with server configurations (see example below)
64 
65### 📋 Example mcp.json:
66 
67```json
68{
69  "mcpServers": {
70    "filesystem": {
71      "command": "npx",
72      "args": ["@modelcontextprotocol/server-filesystem"],
73      "config": {
74        "directories": ["D:\\Cursor Projects\\CursorRIPER.sigma"]
75      }
76    },
77    "github": {
78      "command": "npx",
79      "args": ["@modelcontextprotocol/server-github"],
80      "env": {
81        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
82      }
83    },
84    "brave-search": {
85      "command": "npx",
86      "args": ["@modelcontextprotocol/server-brave-search"],
87      "env": {
88        "BRAVE_SEARCH_API_KEY": "${BRAVE_SEARCH_API_KEY}"
89      }
90    },
91    "playwright": {
92      "command": "npx",
93      "args": ["@executeautomation/playwright-mcp-server"]
94    },
95    "docker": {
96      "command": "npx",
97      "args": ["docker-mcp"]
98    }
99  }
100}
101```
102 
103### 🔗 Service Integration Map:
104 
105```
106Composite Operations = {
107  Θ×Ξ: deploy_from_github(),      # GitHub → Docker
108  Λ×Θ: search_and_clone(),       # Search → GitHub  
109  Υ×Θ: test_and_commit(),        # Test → GitHub
110  Φ×Θ: sync_local_to_github()    # Files → GitHub
111}
112```
113 
114### ⚠️ Important Notes:
115 
116- Services are independent and can be enabled/disabled individually
117- Missing services gracefully degrade with warnings
118- Mode restrictions apply to all MCP operations
119- Protection levels enforce security on sensitive operations
120- Context tracking maintains state across operations
121 
122For detailed service documentation, see:
123- `/docs/mcp/` directory for setup guides
124- Individual service rule files for operation details
125