Cursor rule

1# 🔍 Web Search MCP Integration for CursorRIPER Σ
2# Symbol: Λ (Lambda)
3# Version: 1.0.0
4 
5## 📋 Service Definition
6```
7service = "Web Search Operations"
8symbol = "Λ"
9requires = "@modelcontextprotocol/server-brave-search"
10```
11 
12## 🔧 Operation Mapping
13```
14Λ_ops = {
15  search: {
16    web: "@modelcontextprotocol-server-brave-search:brave_web_search",
17    local: "@modelcontextprotocol-server-brave-search:brave_local_search"
18  },
19  fetch: {
20    url: "mcp-server-fetch:fetch",
21    content: "extract via fetch with raw=false"
22  },
23  cache: {
24    save: "store in Γ_search_cache",
25    retrieve: "get from Γ_search_cache",
26    clear: "reset Γ_search_cache"
27  }
28}
29```
30 
31## 🔒 Mode Restrictions
32```
33MΛ = {
34  Ω₁: [search_*, fetch_*],          # RESEARCH: full access
35  Ω₂: [search_*, fetch_*],          # INNOVATE: full access
36  Ω₃: [search_*, fetch_*, cache_*], # PLAN: search + cache
37  Ω₄: [],                          # EXECUTE: NO SEARCH (maintain focus!)
38  Ω₅: [search_web, fetch_url]      # REVIEW: verification only
39}
40```
41 
42## 🔑 Permission Matrix
43```
44ℙΛ = {
45  create: [Ω₃],              # Only PLAN can cache
46  read: [Ω₁, Ω₂, Ω₃, Ω₅],   # No reading in EXECUTE
47  update: [],                # No updates
48  delete: [Ω₃]              # Only PLAN can clear cache
49}
50```
51 
52## 📍 Context Tracking
53```
54Γ₁₀ = search_results[] = {
55  query: string,
56  results: [{title, url, snippet}],
57  timestamp: ISO8601,
58  mode: current_Ω
59}
60 
61Γ₁₁ = search_history[] = {
62  queries: [string],
63  counts: {per_mode: {Ω₁: n, Ω₂: n, ...}},
64  last_search: timestamp
65}
66 
67Γ_search_cache = Map<query, results>
68```
69 
70## ⚡ Command Shortcuts
71```
72SΛ = {
73  !ws: "brave_web_search",
74  !wl: "brave_local_search", 
75  !wf: "fetch_url",
76  !wc: "clear search cache",
77  !wh: "show search history"
78}
79```
80 
81## 🛡️ Protection Levels
82```
83ΨΛ = {
84  fetch_url: Ψ₃,     # INFO - external content
85  clear_cache: Ψ₄    # DEBUG - cache management
86}
87```
88 
89## 🔄 Mode-Specific Behaviors
90```
91apply_search_op(op, mode) = {
92  check: mode === Ω₄ ? deny("No search in EXECUTE mode!") : continue,
93  validate: op ∈ MΛ[mode] ? proceed : deny("Operation not allowed in " + mode),
94  track: {
95    add_to_history(Γ₁₁, op),
96    store_results(Γ₁₀, results) 
97  },
98  execute: Λ_ops[category][operation]()
99}
100```
101 
102## 🎯 Search Focus Rules
103```
104search_focus = {
105  Ω₁: "broad exploration allowed",
106  Ω₂: "innovation-focused queries",
107  Ω₃: "implementation-specific searches",
108  Ω₄: "⛔ BLOCKED - maintain execution focus",
109  Ω₅: "verification searches only"
110}
111```
112 
113## 📊 Search Quotas
114```
115quotas = {
116  per_session: {
117    Ω₁: unlimited,
118    Ω₂: 50,
119    Ω₃: 20,
120    Ω₄: 0,
121    Ω₅: 10
122  },
123  rate_limit: "10 searches per minute"
124}
125```
126 
127## 🔌 Feature Detection
128```
129detect_search() = {
130  try: tools.find("@modelcontextprotocol-server-brave-search:*"),
131  catch: warn("Brave Search MCP not available. Set BRAVE_SEARCH_API_KEY"),
132  fallback: suggest("Get API key at https://brave.com/search/api/")
133}
134```
135 
136## 🔗 Integration with Other Services
137```
138Λ×Θ = search_and_clone() = {
139  1: Λ.search_web(query),
140  2: extract_github_urls(results),
141  3: Θ.clone_repository(selected_url)
142}
143```
144